Skip to main content
POST
Upload a binary as a typed event

Authorizations

Authorization
string
header
required

Pass your pk_live_... API key as a Bearer token.

Path Parameters

connector_id
string
required

Body

multipart/form-data
file
file
required
kind
string | null
external_id
string | null
payload
string | null

Response

Successful Response

status
string
required

Always 'accepted' (a fully-rejected ingest returns 402).

Example:

"accepted"

events
integer
required

Number of events accepted.

Example:

1

external_ids
string[]

external_id of each accepted event, in submission order. Useful for callers that want to look up the resulting canonical doc.

Example:
rejected
RejectedItem · object[]

Items refused at admission on a partial-accept (some over a tier quota). Empty on full accept; a fully-rejected ingest returns 402 instead.

unchanged
string[]

external_id of each accepted item whose content was byte-identical to the previously ingested version and was therefore not re-processed. Pass force=true to override.