Coding agent documentation index Fetch the complete documentation index at: https://docs.worklittle.com/docs-agent-manifest.json Use this file to discover all available pages before exploring further.

Common API errors

What 401, 402, 403, 429, and 5xx responses mean and how to fix them.

Most API errors come down to the key, its permissions, billing, or request speed.

Status codes

| Code | Meaning | First fix |
| --- | --- | --- |
| 401 | Key not accepted | Check the key, the Bearer header, and whether it was revoked |
| 403 | Key recognized but not allowed to do that | Use a key with the right capabilities |
| 402 | Billing is blocking metered usage | Update the card or raise the spend limit |
| 429 | Too fast, or a free quota is used up | Slow down, wait, or review quotas |
| 5xx | Failure on our side | Check [Service status](/help/api/status-page), then retry |

Common 403 and 400 codes: MISSING_SCOPE (the key lacks that capability), BUSINESS_ACCESS_OFF (a jobs-only key), SHARED_API_KEY (a shared key cannot use one person's profile), APPLICANT_REQUIRED / APPLICANT_ID_REQUIRED (say which person you are applying for). A 409 COMPANY_LIMIT_REACHED means the person reached max_per_company applications at one company in 30 days: resend with a higher max_per_company (up to 10) if they agree.

REST error bodies include error.code and error.message. For 401, 402, 403, and 429 they also include error.documentation_url, which links to the matching Help article.

Related

- Why is my API key not working? - Too many requests and rate limits - Payment required messages - Developer detail: Jobs errors and Business errors