Idempotency
Retry a call without a second job. The key lives for 24 hours.
Send an Idempotency-Key header on POST /v2/{capability}. A retry with the same key and the same body returns the first job. The API starts no second job.
Rules
Answers
A replay waits for the first job under the same Prefer rules. A replay of a job with stale signed URLs gets new URLs.
If the API fails a job with 503 capability_unavailable, it deletes the claim of the key. A retry with the same key then creates a new job.
Retry a failed call
Use the same Idempotency-Key after a network error or a 500. The retry gets the first job and starts no second job. Use a new key when you want a new job.