Pequod
Errors
Metered POSTs fail before the lookup when the key, the body or the balance is wrong. A call that starts and then dies answers 503 and does not commit the reservation.
status
400 · bad body, missing Idempotency-Key, over twenty
401 · missing or invalid key
402 · insufficient credits
409 · Idempotency-Key already in flight
503 · timed out, or the lookup failed
402
Returned before anything runs when available credits are below the reservation. Buy credits from Packs and retry the same request. Body is error, required and available.
402 body
{
  "error": "insufficient credits",
  "required": 3,
  "available": 1
}
idempotency
Idempotency-Key is required on every metered POST. Reuse the same key after a completed call and you get the same result back — no second charge. Send it again while the first call is still running and you get 409. If the first call failed and released the hold, the key is dropped and you may retry it.
400
Invalid JSON, both domain and domains, empty lists, more than twenty items, or a missing Idempotency-Key. The body is {error}.
The request shape lives on the decision makers page.