Errors

​

The shape

{
  "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