LiveStreamIngestRequest

Fields

API-key-authenticated streaming ingest. Server auto-manages the session.

4 fields

batch_id

string or null

Client-generated identity for this batch. The same value must be reused for every HTTP retry; omitted for legacy callers.

events · required

array of LiveEvent

meta

LiveStreamMeta or null

run_id · required

string

Raw schema (JSON)

{
  "description": "API-key-authenticated streaming ingest. Server auto-manages the session.\n\nA client-chosen ``run_id`` (any stable identifier — CI build id, UUID, etc.)\nkeys the live session along with the API key's bound project. The first\ncall for a given ``(project_id, run_id)`` pair auto-creates the session;\nsubsequent calls reuse it. Clients never call ``/sessions`` themselves.",
  "properties": {
    "batch_id": {
      "anyOf": [
        {
          "maxLength": 255,
          "minLength": 1,
          "pattern": "^[^\\x00-\\x1f\\x7f]+$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Client-generated identity for this batch. The same value must be reused for every HTTP retry; omitted for legacy callers.",
      "title": "Batch Id"
    },
    "events": {
      "items": {
        "$ref": "#/components/schemas/LiveEvent"
      },
      "maxItems": 1000,
      "minItems": 1,
      "title": "Events",
      "type": "array"
    },
    "meta": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/LiveStreamMeta"
        },
        {
          "type": "null"
        }
      ]
    },
    "run_id": {
      "maxLength": 100,
      "minLength": 1,
      "title": "Run Id",
      "type": "string"
    }
  },
  "required": [
    "run_id",
    "events"
  ],
  "title": "LiveStreamIngestRequest",
  "type": "object"
}

Used by endpoints

One endpoint sends or returns this schema, on its own or inside another schema.

• POST /api/v1/stream/ingest — Ingest Via Api Key

Used by schemas

No other schema contains this one.

More details

• Specification: OpenAPI JSON