Idempotency

Retry OrgX mutations safely with the Idempotency-Key header.

Send an Idempotency-Key header with every state-changing workspace request:

Idempotency-Key: launch-plan-review-001

The key is scoped to the workspace and accepts 1–200 characters matching ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}$.

Request	Result
First key and input	The operation runs and returns its created or accepted result
Same key and same input	200 returns the original result
Same key and different input	409 reports an idempotency conflict

Keep the same key after a timeout, 429, or retryable server error. Generate a new key when the user intends a new operation.

curl https://useorgx.com/api/v1/work \
  -X POST \
  -H "Authorization: Bearer $ORGX_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: launch-plan-review-001' \
  -d '{"title":"Review the launch plan"}'

Read-only and account-free validation requests do not need an idempotency key. Stripe callback delivery uses the provider event identity and signature instead.