ingest (caller retry policy, lost
response) must not append the transcript twice. Opt in by sending an
Idempotency-Key header.
Authorization
string
required
Your bearer token:
Bearer <token>. See Authentication.Idempotency
string
A caller-chosen unique key for this write. A second request with the same
key replays the recorded response instead of re-running the write, so a
network retry never appends the same messages twice.
Request body
Message[]
required
The messages to append, in conversation order. Must contain at least one
message.
Request
Response
integer
The number of messages appended to the scope (matches the length of the
request
transcript).200 OK
Errors
ingest only validates and stores the request — it runs no analysis and is
not billable, so it does not return 400 VALIDATION_ERROR for a failed
analysis, 402 PAYMENT_REQUIRED, or 502 UPSTREAM_ERROR.
See Errors for the full envelope shape.

