API errors

locked

A request with the same `X-Idempotency-Key` is still being processed. Wait briefly, then retry with the same key.

423application/problem+json

What it means

Two requests with the same X-Idempotency-Key arrived close together, and the first has not finished. The API refuses the duplicate while the original is in flight.

423 · application/problem+json

{
  "type": "https://developers.firsty.app/errors/locked",
  "title": "Locked",
  "status": 423,
  "detail": "A request with this idempotency key is already being processed. Please retry later.",
  "code": "locked"
}

How to handle it

Wait briefly and retry with the same key. Once the original finishes, the retry returns its response.
Do not switch to a fresh key while the original may still be running; that would run the operation twice.
If the same key keeps returning this error for more than a few minutes, contact Firsty support with the X-Request-Id response header value.

Errors reference