API errors
Errors are application/problem+json (RFC 9457). The type of each problem links to its entry here; branch on the stable code, never on detail.
| Code | Status | Meaning |
|---|---|---|
| bad_request | 400 | The request is malformed or breaks a rule that is not a field validation, for example an unreadable cursor or a missing Idempotency-Key header. |
| unknown_plan | 400 | The plan key does not exist. |
| invalid_webhook_signature | 401 | A provider webhook callback failed signature verification and was ignored. |
| unauthorized | 401 | The credential is missing, invalid, expired or revoked. |
| insufficient_credits | 402 | The workspace balance cannot cover the credits this action reserves. Top up or reduce the request. |
| email_not_verified | 403 | The action needs a verified email address; verify it and retry. |
| forbidden | 403 | The credential is valid but lacks the scope the route requires, or a CSRF token is missing on a session request. |
| sandbox_unsupported | 403 | A test key (li_test_) cannot call this route; use a live key or the web app. Test keys reach only searches, enrichments, lookups and events. |
| signup_invite_only | 403 | Open signup is disabled on this deployment; ask a workspace admin for an invitation link. |
| tenant_suspended | 403 | The workspace is suspended or being deleted; every credential of that tenant is refused until a platform admin reactivates it. |
| http_404 | 404 | No route matches the path. |
| not_found | 404 | The resource does not exist in this tenant. Resources of other tenants are reported the same way. |
| organization_not_found | 404 | No organization matches the id or lookup criteria. |
| http_405 | 405 | The route does not support this HTTP method. |
| billing_not_configured | 409 | No payment provider is configured for this deployment (`LI_BILLING_PROVIDER=none`); use manual invoicing through the admin credit API. |
| checkout_unavailable | 409 | The workspace is deleting or was suspended by a platform admin, so it cannot start a checkout; only active or billing-suspended workspaces can pay. |
| conflict | 409 | The request conflicts with current state, for example a duplicate name. |
| debit_exceeds_balance | 409 | A credit debit would take the balance below zero. |
| deletion_grace_expired | 409 | The deletion grace period is over; the deletion cannot be cancelled. |
| deletion_not_pending | 409 | There is no pending deletion to cancel. |
| idempotency_in_progress | 409 | A request with this Idempotency-Key is still running; retry after a short delay. |
| idempotency_key_reused | 409 | The Idempotency-Key was already used on this route with a different body. Use a new key for a different request. |
| idempotency_secret_already_issued | 409 | The original request issued a one-time secret that is never replayed. Create a new resource with a new key. |
| removal_needs_mapping | 409 | The removal request names free text, a shared or free-mail domain, or no registrable domain, or a person request by email or phone names no person_ids, so it cannot be applied automatically; map it to an organization id, a company domain or the person's per_ ids (person_ids in the approve body), or reject it. |
| tenant_deleting | 409 | The tenant is being deleted and cannot be changed this way. |
| http_413 | 413 | The request body exceeds the size limit. |
| upload_too_large | 413 | The uploaded file is larger than the plan's upload size limit. |
| http_415 | 415 | The Content-Type is not supported; send `application/json`. |
| unsupported_media_type | 415 | The upload's `Content-Type` differs from the type declared when the upload was created. |
| validation_error | 422 | A body, path or query field failed validation. `errors` lists each field with its location and message. |
| job_limit_exceeded | 429 | The workspace already runs its plan's maximum of concurrent bulk jobs. Wait for one to finish. |
| rate_limit_exceeded | 429 | Too many requests. Wait for `Retry-After` seconds; see the `RateLimit-*` headers. |
| internal_error | 500 | An unexpected server error. Retry with backoff and quote `request_id` when you contact support. |
| billing_provider_error | 502 | The payment provider rejected or could not complete the request; retry later. No payment was recorded as succeeded. |