Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

nia_sk_...

Headers

Idempotency-Key
string
required

Required. Kept 24 hours with the hash of the body: a retry with the same key returns the first answer, and the same key with a different body returns 409 conflict.

Required string length: 1 - 256

Body

application/json

Moves turns from the short tier (every turn, 7 days) to the kept one, by conversation or by id, with the reason: the complaint arrives days after the turn.

reason
enum<string>
required
Available options:
complaint,
bug_report,
review,
other
conversation_id
string | null
Required string length: 1 - 512
turn_ids
string[]
Maximum array length: 500
Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

Response

Successful Response

already_kept
integer
required
not_found
integer
required

Turns no longer in the short tier, or never recorded.

promoted
integer
required