Skip to content

Document Idempotency-Key reuse on 409 conflict errors - #591

Open
jspaetzel wants to merge 1 commit into
mainfrom
docs/idempotency-409-conflict
Open

jspaetzel wants to merge 1 commit into
mainfrom
docs/idempotency-409-conflict

Conversation

@jspaetzel

Copy link
Copy Markdown
Member

Summary

  • Explain in the 409 conflict error catalog that a POST or PUT can return 409 when an Idempotency-Key is reused with different parameters, or while the original request is still in progress.
  • Describe how to retry with the same key, including the 24-hour window and Idempotent-Replayed: true.
  • Regenerate openapi.yaml, openapi-fern.yaml, and openapi-sdk.yaml from the updated translation.

Test plan

  • Confirm ErrorCatalog::conflict::SUMMARY is unchanged and the conflict cause and remediation mention key reuse.
  • Confirm x-error-codes.conflict in openapi.yaml, openapi-fern.yaml, and openapi-sdk.yaml matches the translation.
  • Confirm no other spec text changed.

Made with Cursor

Callers need to know a reused key or an in-progress POST or PUT can return 409, and how to retry with the same key.

Co-authored-by: Cursor <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant