Handle errors and rate limits
Preserve the request body and Idempotency-Key before sending a validation.
- Read
200 completedas a completed determination, includinguncertain. - Read POST
202 in_progressas accepted work; save its ID for GET retrieval. - On GET HTTP 200, inspect
status: it may still be active or contain a stored failure. - Correct
401,403, and422before another attempt. - Reconcile
409using the idempotency rules. - On
429, distinguish request-rate exhaustion from organization VU capacity. Inspect usage and respectRetry-Afterwhere supplied. - Preserve identity after a transport failure: outcome may be unknown. Use retrieval or deliberate same-key replay.
Do not automatically retry a POST just because a response is 500, 502, 503, or 504. A stored hybrid failure is terminal. See Errors for exact HTTP and sanitized failure mappings.
GET adds no VUs, but remains subject to authentication and request-rate controls. Avoid aggressive polling; respect the returned Retry-After header before a later retrieval.