Skip to content

Error reference

`missing_scope`

HTTP status: 403 Forbidden
Returned by: Apps and the app platform; Members and invites; Webhooks

What it means

The API key or app token does not have a scope this endpoint requires. scope names it.

Typical causes

The key was created without the scope, for example webhooks:manage or users:read.

How to fix it

Create a key with the scope named in scope (scopes cannot be added to an existing key).

Messages

English text, as sent with Accept-Language: en. With ru or uz the API sends the translation.

This API key needs the users:read scope.
RU: Этому API-ключу нужно право users:read.
UZ: Bu API kalitga users:read ruxsati kerak.
This API key needs the webhooks:manage scope.
RU: Этому API-ключу нужно право webhooks:manage.
UZ: Bu API kalitga webhooks:manage ruxsati kerak.
This app may not add UI to Kweko.
RU: Этому приложению нельзя добавлять интерфейс в Kweko.
UZ: Bu ilova Kweko ga interfeys qoʻsha olmaydi.

Example response

Response

HTTP/1.1 403 Forbidden
Content-Type: application/json; charset=utf-8
X-Request-Id: req_4f2a9c1e0b7d3a55

{
  "error": {
    "code": "missing_scope",
    "message": "This API key needs the webhooks:manage scope.",
    "request_id": "req_4f2a9c1e0b7d3a55",
    "docs_url": "https://developers.kweko.uz/errors/missing_scope",
    "scope": "webhooks:manage"
  }
}

forbidden

All error codes · The error format