Skip to content
Getting started

Idempotency

Retry a request safely with a stable idempotency key.

Send Idempotency-Key on retries. For format=json, DeepSearch stores and replays the completed JSON response when the same key and body are used again. If the same key is reused with a different body, the API returns 409 idempotency_conflict.

  • For SSE requests, idempotency protects wallet spend but does not replay a prior event stream.
  • Responses include X-Request-Id, X-DeepSearch-Metered, X-DeepSearch-Credits-Charged, and standard RateLimit-* headers.
  • Request bodies are capped at 64KB; chat requests accept up to 20 messages.