> ## Documentation Index
> Fetch the complete documentation index at: https://help.skillsdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> RFC 9457 problem details — the one error shape the API emits

<Info>
  **Quick Summary:** Every error is `application/problem+json` with a `type` URL that resolves to the [error catalogue](/api-docs/errors/index). Log the `requestId` from every response — it is the tracing handle for support.
</Info>

## The shape

```json theme={null}
{
  "type": "https://help.skillsdb.com/api-docs/errors/insufficient-scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "This credential does not have the 'careers:write' scope",
  "instance": "/api/v1/careers",
  "requestId": "01a01ed7-a41b-7183-a017-be375fd23874"
}
```

* `type` — a URL naming the error class; open it for causes and fixes.
* `detail` — human-readable specifics of this occurrence.
* `instance` — the path that produced it.
* `requestId` — also sent as the `X-Request-Id` header on **every** response, success or failure.
* `errors[]` — on validation failures, the per-field breakdown.
* Some errors add extension members (for example a guarded delete `dependencies` counts).

## Status codes at a glance

| Status | Types                                                                                                    |
| ------ | -------------------------------------------------------------------------------------------------------- |
| 400    | [validation-error](/api-docs/errors/validation-error)                                                    |
| 401    | [invalid-credential](/api-docs/errors/invalid-credential)                                                |
| 403    | [insufficient-scope](/api-docs/errors/insufficient-scope)                                                |
| 404    | [not-found](/api-docs/errors/not-found)                                                                  |
| 409    | [conflict](/api-docs/errors/conflict), [idempotency-key-reused](/api-docs/errors/idempotency-key-reused) |
| 410    | [version-gone](/api-docs/errors/version-gone)                                                            |
| 422    | [unprocessable](/api-docs/errors/unprocessable)                                                          |
| 429    | [rate-limit-exceeded](/api-docs/errors/rate-limit-exceeded)                                              |
| 500    | [internal-error](/api-docs/errors/internal-error)                                                        |