Summary
Read one Idempotency-Key on this account. Requires message_read. :key is the header value, URL-encoded. The response is key, state (in_progress, done, or unknown), endpoint, inbox_id, message_id, created_at, expires_at, and unknown_since and last_error when they are set. A missing key is HTTP 404 idempotency_key_not_found. An inbox-scoped key only sees a row for its inbox, and anything else is HTTP 404 idempotency_key_not_found. An in_progress row older than 10 minutes is returned as unknown. MCP: cooper_get_idempotency_key. Guide: /docs/idempotency.
Request
This call has no JSON body.
Response
The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.Errors
- HTTP 404 idempotency_key_not_found
Idempotency
Idempotency-Key is 1 to 256 characters of letters, digits, and - . _ ~. The same key and the same request within 24 hours returns the original response with HTTP 200 and Idempotent-Replayed: true. A different request is HTTP 409 idempotency_key_conflict. A second call while the first is running is HTTP 409 idempotency_request_in_progress. An empty or invalid key is HTTP 400 invalid_idempotency_key. A definitive refusal removes the key. An ambiguous failure keeps it and the same request returns HTTP 409 idempotency_outcome_unknown. client_id is checked first when both are set. Done keys expire after 24 hours. Unknown keys are kept for 7 days.