Public validator

Validate SignalOps event payloads before you wire protected ingest.

This endpoint is public, zero-storage, and strict on shape. It validates a single event or a bounded batch, redacts `user` and `prompt`, and returns readiness feedback plus the gaps still blocking a real ingest path.

Request bounds

256 KB

Header and actual UTF-8 body both enforced.

Batch bounds

100 events

Partial rejection supported inside the limit.

Current contract

Public `POST /api/events/validate` accepts `application/json` only.
Telemetry must be finite and nonnegative; `retryCount` must be an integer.
Future timestamps are rejected. Accepted previews are redacted and never stored.

Editable playground

Start with a sample, edit the JSON, then run the same validator response your integration would receive from the public dry-run endpoint.

Pilot-ready batch: Shows lifecycle, latency, cost, retries, and provider health coverage.

Partial batch: One accepted event and one rejected event to show batch-level feedback.

Invalid event: Highlights strict JSON-contract errors before any protected ingest exists.

{
  "events": [
    {
      "type": "generation.started",
      "occurredAt": "2026-07-01T12:00:00.000Z",
      "generationId": "gen_public_001",
      "providerId": "fal",
      "modelId": "flux-kontext-pro",
      "source": "public-api",
      "status": "running",
      "user": "ops@signalops.cc",
      "prompt": "cinematic portrait with rain"
    },
    {
      "type": "generation.retrying",
      "occurredAt": "2026-07-01T12:00:10.000Z",
      "generationId": "gen_public_001",
      "providerId": "fal",
      "modelId": "flux-kontext-pro",
      "source": "public-api",
      "status": "retrying",
      "retryCount": 1,
      "durationMs": 8200
    },
    {
      "type": "generation.completed",
      "occurredAt": "2026-07-01T12:00:31.000Z",
      "generationId": "gen_public_001",
      "providerId": "fal",
      "modelId": "flux-kontext-pro",
      "source": "public-api",
      "status": "succeeded",
      "durationMs": 18340,
      "cost": 0.057
    },
    {
      "type": "provider.health",
      "occurredAt": "2026-07-01T12:01:00.000Z",
      "providerId": "fal",
      "source": "health-monitor",
      "statusMessage": "Latency stabilized after regional failover."
    }
  ]
}

Ready to validate

Public verification only. No events are persisted from this endpoint.

The response pane will show accepted counts, rejected item detail, readiness, gaps, and a redacted preview of the first accepted events.