Skip to main content
PUT
Ingest an event into a named dataset (PUT alias of ingestEventToDataset)

Authorizations

Authorization
string
header
required

An ik_live_… ingest key. Stored hashed; the plaintext is returned once at creation.

Headers

Idempotency-Key
string

Optional; a repeat key short-circuits with 200 before quota is charged.

X-Hookie-Signature
string

Required only when the key has require_signature. Format 't=,v1='.

Path Parameters

ingest_key
string
required

The plaintext ingest key.

dataset
string
required

Dataset name; forces identity routing (mapping rules are not consulted).

Body

Identical to the POST form: form encodings flattened, everything else parsed as JSON, empty body becomes {}, non-object payloads wrapped as {"value": }, 1,000,000-byte cap.

Any JSON value.

Response

Idempotent replay under an existing Idempotency-Key.

submission_id
string
required
idempotent
enum<boolean>
required
Available options:
true