Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Every error type the SkillsDB REST API can return, and exactly what to do about each
type field is a URL that resolves to a page in this catalogue telling you what happened and what to do.Content-Type: application/problem+json and this shape:
{
"type": "https://help.skillsdb.com/api-docs/errors/validation-error",
"title": "Validation failed",
"status": 400,
"detail": "limit must be at most 200",
"instance": "/api/v1/careers",
"requestId": "01a01ed7-a41b-7183-a017-be375fd23874",
"errors": [{ "field": "limit", "code": "out_of_range", "message": "..." }]
}
requestId — it is the one string SkillsDB support can trace a request by. Some errors carry extra fields (extension members), documented on their pages.
| Type | Status | When |
|---|---|---|
| validation-error | 400 | The request itself is malformed |
| invalid-credential | 401 | The API key is missing, wrong, expired or revoked |
| insufficient-scope | 403 | The key or its acting person lacks the permission |
| not-found | 404 | No such resource in your company |
| method-not-allowed | 405 | The path exists, but not for this HTTP method |
| conflict | 409 | The current state of the resource refuses the request |
| idempotency-key-reused | 409 | Same Idempotency-Key, different content |
| version-gone | 410 | The API version was sunset |
| unprocessable | 422 | Well-formed, but rejected by a business rule |
| rate-limit-exceeded | 429 | Over the hourly allowance |
| internal-error | 500 | Our fault — quote the requestId to support |