Skip to main content
POST
Ingest typed first-party events

Path Parameters

connector_id
string
required

Body

application/json
items
TypedIngestItem · object[]
required

Events to ingest, at most 500 per request. Chunk larger loads into multiple requests.

Required array length: 1 - 500 elements
force
boolean
default:false

Re-process items even when their content is byte-identical to what was previously ingested for the same external_id. Without this, unchanged re-pushes are acknowledged but skipped (reported in unchanged).

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: