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

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.

ignored_fields
Ignored Fields · object

Payload fields the item's kind does not define, by external_id. They are kept in the stored raw copy but do not reach typed evidence or search. Empty when every field was used. For kind 'email' the evidence catalogue's names body_text and body_excerpt are accepted as body and body_snippet.

Example: