/v1/ingest-sessions (POST)

POST

/v1/ingest-sessions

curl --request POST \
  --url https://api.reindeer.example.tr/v1/ingest-sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "partition": "example", "mode": "initial", "pointers": { "id": "/order_id", "author": "/buyer_id", "ts": "/placed_at", "ts_format": "unix" } }'

Scope ingest:write. Initial sessions publish on commit; incremental sessions publish each verified batch.

Authorizations

• mutualTLS
• session

Parameters

Header Parameters

Idempotency-Key

string

<= 255 characters

Request Body^required

Media typeapplication/json

object

partition

required

string

/^[a-z0-9][a-z0-9_-]{0,31}$/

mode

required

string

Allowed values: initial incremental

pointers

required

object

id

required

JSON pointer to the record id. The value may be a string of at most 256 bytes or a number.

string

Example

/order_id

author

required

JSON pointer to the record’s owner: the person, account or device it belongs to. Deletions of kind author use it.

string

Example

/buyer_id

ts

required

string

Example

/placed_at

ts_format

required

string

Allowed values: unix unix_ms rfc3339 twitter

Responses

201

Session opened