---
title: "Rotate Account Key"
method: POST
path: "/account/keys/{key_id}/rotate"
---

# Rotate Account Key

`POST /account/keys/{key_id}/rotate`

## Request

- Base URL: `https://www.clipzyn.com/v1`
- URL: `https://www.clipzyn.com/v1/account/keys/{key_id}/rotate`
- Auth: HTTP bearer

Atomically revoke one owned key and return its replacement exactly once.

Costs nothing quota-wise. The replacement keeps the old key's name and
scopes; the old credential stops authenticating as soon as this call commits.
Recover from not_found by listing keys and using an active owned id, from
scope_missing with an owner-authorized key, and from rate_limited or
service_unavailable by waiting retry_after_sec before retrying once.

## Path parameters

- `key_id` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clipzyn/apis/clipzyn-api.md) · [All operations](https://skmtc.dev/clipzyn/apis/clipzyn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clipzyn/apis/clipzyn-api/revisions/a0f30a836536?raw)