| 400 | idempotency_key_required | POST /v1/commits without an Idempotency-Key header. | Send one, such as a UUID. |
| 400 | unsupported_api_version | Abacus-Version is not a released version date (or is in the future). | Send 2026-11-15, or leave the header out. |
| 401 | unauthorized | Missing, unknown or revoked key. | Send Authorization: Bearer <key>. Get a key with POST /v1/keys. |
| 402 | credits_exhausted | Not enough credits this month, or a spend cap is reached. | See Credits. |
| 402 | max_credits_exceeded | The call costs more than max_credits. | Raise max_credits or lower effort. |
| 402 | portfolio_limit_reached | A new account would pass the plan’s portfolio limit. | Use an account already counted, or upgrade. |
| 403 | forbidden | The key lacks the scope for this call. | Use a key with read, propose and commit. |
| 404 | not_found | Unknown account, proposal, option or commit for this key. | Check the id. Ids belong to the key’s organisation. |
| 404 | snapshot_not_found | Unknown or expired snapshot_id. | Send the account again. |
| 404 | not_available | The route is not part of the public API. | Use the calls in the API reference. |
| 405 | method_not_allowed | The path exists, but not with this HTTP method. | Check the method in the API reference. |
| 409 | stale_snapshot | Commit: the holdings changed since the option was made. | Show replacement_option_id to the person, then commit it. Or propose again. |
| 409 | prices_moved | Commit: a traded price moved more than 1%. | Same as above. |
| 409 | option_already_committed | Commit: this option was already committed with another Idempotency-Key. | GET /v1/commits/{commit_id} (in the error). |
| 409 | idempotency_conflict | Commit: this Idempotency-Key was used with a different body. | Use a new key for a new request. |
| 409 | idempotency_key_reused | A paid call: this Idempotency-Key was used with a different route or body in the last 24 hours. | Use a new key for a new request. |
| 409 | idempotency_in_progress | A paid call: the first request with this key is still running. | Retry after Retry-After seconds; you get its answer. |
| 409 | reference_conflict | Commit: reference is already used by another commit. | Use a new reference. |
| 409 | rules_failed | Commit: the option no longer passes the rules at today’s prices. | Propose again. |
| 409 | resolve_failed | Commit with on_stale: "resolve": the option is stale and could not be re-solved. | Propose again. |
| 409 | overfill, fill_exceeds_position | Commit: a fill is larger than the trade or the holding. | Send the fills as the broker reported them. |
| 410 | option_expired | Commit: the option is older than 15 minutes. | Show replacement_option_id to the person, or propose again. |
| 413 | payload_too_large | The request body is above 2 MB. | Save the account once (POST /v1/accounts) and send account_id. |
| 422 | invalid_request | A field is missing or wrong. param names it. | Fix the field. |
| 422 | invalid_policy | A policy field is wrong or unknown. param names it. | See The policy. |
| 422 | invalid_benchmark | Abacus Labs could not read the benchmark. | Use a ticker, an index name or a benchmark object. |
| 422 | account_id_required | Several accounts were sent to a proposal or check without account_id. | Say which account to trade in. accounts in the error lists them. |
| 422 | duplicate_account | The same account id was sent twice. | Send each account once. |
| 422 | unsupported | The request needs something Abacus Labs cannot do. | The message says what. Add a goal in plain English, or change the policy. |
| 429 | rate_limited | Too many calls today for this key, or too many new keys from this address. | Wait until 00:00 UTC, or use a live key. |
| 500 | internal_error | A fault on our side. | Retry once. If it repeats, report the request_id. |
| 503 | llm_unavailable | Analyze needs a language model and none answered. | Retry later. |