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

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

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

## Описание

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

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

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

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

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

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

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

**Ответ:** 200 `application/json`, [ApiKeyCreated](/docs/schemas#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`; [общие ошибки](/docs/errors).

**Лимиты:** Те же ограничения создания: до 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'
```

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

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [ApiKeyCreated](/docs/schemas#apikeycreated) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, CREDENTIAL_NOT_ALLOWED, REAUTH_REQUIRED, NOT_FOUND, KEY_LIMIT, KEY_RATE |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `keysRotate`.
