insufficient_scope

HTTP status: 403 Forbidden

What happened

The key lacks a scope the operation needs (x-komplai-scopes): it was not issued or created with it, its person is no longer assigned the app, or the organisation's processing approval no longer covers it.

What to do

Use a key with the scope, or ask your organisation's administrator about the assignment.

Example

JSON

{
  "error": "insufficient_scope",
  "request_id": "0f8e2c4a-6b1d-4e3f-9a7c-5d2b8e1f4a60",
  "doc_url": "https://developers.komplai.dk/errors/insufficient_scope"
}

Every response carries a Request-Id header, and an error body repeats it as request_id. Quote it when you ask komplai about a call.

Endpoints that can return it

POST /v1/redact Pseudonymise a text
POST /v1/redact/detect Find personal data in a text
POST /v1/redact/restore Restore the originals in a text
POST /v1/redact/jobs Submit a text job
GET /v1/redact/jobs/{id} Read the status of a text job
DELETE /v1/redact/jobs/{id} Delete a text job
GET /v1/redact/jobs/{id}/result Read the result of a text job
POST /v1/redact/file Pseudonymise the text of a PDF or Word file (beta)
POST /v1/redact/file/jobs Submit a PDF or Word file as a text job (beta)
GET /v1/access Read what this key can reach
GET /v1/models List the permitted chat models
POST /v1/chat/completions Create a chat completion
POST /v1/decide Evaluate one text
POST /v1/decide/batch Evaluate several texts
GET /v1/coding/account Read the coding account
GET /v1/coding/models List the coding models
POST /v1/coding/chat/completions Stream a coding completion

All error codes