POST Management API

Ключи `sk-mgmt-…` для CI и скриптов. Организация берётся из ключа или cookie-сессии, в путь её не пишут.

Ключ повторяет кабинет того, кто его выпустил: участник видит и меняет только своё пространство, владелец и администратор — организацию. В ответе поле issuerRole — роль на момент выпуска (owner, admin или developer).

Ключ с "readOnly": true внутри этой области только читает (GET, HEAD). Любое изменение отвечает 403. Режим задаётся при создании и потом не меняется. Без поля ключ может делать то же, что выпустивший его человек в кабинете.

Выпуск — только из cookie-сессии. Наблюдатель ключ выпустить не может. Участник видит и отзывает только свои ключи. Владелец и администратор видят и отзывают ключи владельцев и администраторов, без ключей участников.

Не ключ моделей

sk-… / sk-router-… на management-маршрутах даёт 401. Bearer токена сессии на этих путях больше нет — cookie или sk-mgmt-.

POST
/api/organization/management-api-keys

Выпуск только из cookie-сессии владельца, администратора или участника. Ключ действует в рамках прав выпустившего. Наблюдатель выпустить ключ не может. readOnly: true запрещает изменения внутри той же области. Участник видит и отзывает только свои ключи. Владелец и администратор видят и отзывают ключи владельцев и администраторов, без ключей участников.

АвторизацияBearer <token>

Токен сессии кабинета или ключ sk-mgmt-…. Не sk-… моделей.

Где: header

Тело запроса

application/json

Тело ответа

application/json

curl -X POST "https://example.com/api/organization/management-api-keys" \  -H "Content-Type: application/json" \  -d '{    "alias": "finance-watch",    "readOnly": true  }'
{}
GET
/api/organization/management-api-keys
АвторизацияBearer <token>

Токен сессии кабинета или ключ sk-mgmt-…. Не sk-… моделей.

Где: header

Тело ответа

application/json

curl -X GET "https://example.com/api/organization/management-api-keys"
[
  {}
]
POST
/api/organization/management-api-keys/{keyId}/revoke
АвторизацияBearer <token>

Токен сессии кабинета или ключ sk-mgmt-…. Не sk-… моделей.

Где: header

Параметры пути

keyId*string

Тело ответа

application/json

curl -X POST "https://example.com/api/organization/management-api-keys/string/revoke"
{}

Новый ключ выпускается из cookie-сессии и не может выпустить следующий ключ управления.

Что дальше

На этой странице