429 with a plain-text body.
Client behavior
- Stop sending immediate retries.
- Retry with exponential backoff and random jitter.
- Cap concurrent requests and increase concurrency gradually.
- Use cursor pagination rather than issuing parallel requests for every resource id.
429 response is returned before a create operation consumes its
X-Idempotency-Key, so the request can be sent after backoff with that key. If
the connection fails without a response, do not assume the key remains
available: follow the idempotency guidance
and reconcile through the resource’s list and retrieve endpoints.