Idempotency

Use Idempotency-Key on supported non-streaming POST requests:

• POST /v1/conversations
• POST /v1/messages
• POST /v1/conversations/{conversationId}/messages

Behavior

• Matching retries replay the original completed response
• Reusing a key with a different request body returns 409 idempotency_conflict
• Streaming requests do not support Idempotency-Key

Header format

Use any stable string from your system, such as a request UUID or a composite key that combines user ID and message ID.