У роли слишком много прав для сервисного ключа

Moses SkodaИнженер1 мин чтения

При этой ошибке API возвращает 403 Forbidden. Значение type — https://lingo.dev/docs/api/errors/service-key-role-too-broad. Общую структуру ошибок см. в разделе Ошибки и коды состояния.

Не удаётся назначить роль <id> сервисному ключу API: роль такого ключа может давать только права engine:read и engine:translate, а эта роль также даёт право org:manage_team. Выберите роль с меньшим набором прав или создайте новую для этого ключа.

Поля#

Помимо стандартных полей type, status, title и detail, тело ответа содержит следующие поля. На их основе формируется текст detail, поэтому клиент может показывать собственный текст вместо него.

ПолеТип
idstring
permissions("org:manage_team"

Пример#

json
{
  "detail": "Role <id> cannot be given to a service API key: a service key role may only carry engine:read, engine:translate, and this one also grants org:manage_team. Pick a narrower role or create one for the key.",
  "id": "<id>",
  "permissions": [
    "org:manage_team"
  ],
  "type": "https://lingo.dev/docs/api/errors/service-key-role-too-broad",
  "status": 403,
  "title": "Role too broad for a service key"
}

Какие эндпоинты возвращают ошибку#

  • PATCH /v2/service-api-keys/{id}
  • POST /v2/organizations/{orgId}/service-api-keys