К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

REST API

POST/api/v1/keys/{id}/rotate

Атомарно отозвать существующий ключ и выдать новый с тем же именем и scopes на 90 дней.

ПолеЗначение
URLPOST https://aos.edgelab.space/api/v1/keys/{id}/rotate
ДоступCookie кабинета
Scope для ключейключи не принимаются – только кабинет (403 CREDENTIAL_NOT_ALLOWED)
Свежий входне старше 10 минут
operationIdkeysRotate

Описание#

Атомарно отозвать существующий ключ и выдать новый с тем же именем и scopes на 90 дней. Новый secret показывается один раз. Истёкший неотозванный ключ также можно заменить.

Auth: сессия кабинета (cookie). Fresh auth ≤10 минут. Scope: не требуется.

Path (обязателен каждый параметр):

ПолеТипОбязательноОграничения
idstringдаформат "uuid"; pattern см. полную схему

Query: нет объявленных полей.

Body: не требуется.

Ответ · статус и структура

Ответ: 200 application/json, ApiKeyCreated.

Краткая форма: { key: ApiKey, secret: string }.

Пример JSON; значения демонстрационные.

json
{
  "key": {
    "id": "5b8c3e4a-1d6f-4a91-8c3d-4e5f6a7b8c9d",
    "name": "MacBook · Claude Code",
    "prefix": "aos3.sk_EXAMPL",
    "scopes": [
      "course:read",
      "profile:read"
    ],
    "createdAt": "2027-02-01T10:00:00Z",
    "expiresAt": "2027-05-02T10:00:00Z",
    "lastUsedAt": null,
    "revokedAt": null,
    "status": "active"
  },
  "secret": "aos3.sk_EXAMPLE_rotated-not-real_0123456789abcdefgh"
}

Ошибки: 401 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 403 ORIGIN_REJECTED, 422 VALIDATION_FAILED, 403 CREDENTIAL_NOT_ALLOWED, 401 REAUTH_REQUIRED, 404 NOT_FOUND, 409 KEY_LIMIT, 429 KEY_RATE; общие ошибки.

Лимиты: Те же ограничения создания: до 3 активных и 10 созданий/день МСК; заменяемый ключ не занимает дополнительный слот.

bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/keys/00000000-0000-4000-8000-000000000001/rotate \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
  -H 'Origin: https://aos.edgelab.space'

Ответы по контракту#

СтатусТипСхемаОписание
200application/jsonApiKeyCreatedУспех
ошибкаapplication/jsonErrorBodyОшибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, CREDENTIAL_NOT_ALLOWED, REAUTH_REQUIRED, NOT_FOUND, KEY_LIMIT, KEY_RATE

Машиночитаемый контракт: openapi.json, операция keysRotate.