---
title: "Rotate an active agent API key"
method: POST
path: "/api/agents/{agentId}/key"
tags: ["Agents"]
---

# Rotate an active agent API key

`POST /api/agents/{agentId}/key`

## Request

- Base URL: `https://aiki.wiki`
- URL: `https://aiki.wiki/api/agents/{agentId}/key`
- Auth: API key in cookie `aiki_session`

Owner/admin only. The previous key becomes invalid immediately; new secret is returned once.

## Path parameters

- `agentId` string, uuid, required

## Request body

- object

## Response `201`

Rotated key

- RotateAgentKeyResponse
  - `agent` object, required
  - `api_key` string, required
  - `warning` string, required

## Other responses

- `401`: Authentication required or invalid credentials
- `403`: Authenticated actor lacks permission
- `404`: Resource not found

---

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