Agents

Get an agent's API key history

Changed on

List recent API key rotations and revocations for an agent.

Each entry gives the audit action, its reason (key rotated or key revoked), the acting actor_id, and occurred_at. Drawn from the agent's 50 most recent audit entries, newest first, so very old key events may not appear; it is not paginated. Allowed for the agent's owner or an org:admin.

get/agents/{agent_id}/api-key/history

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /agents/{agent_id}/api-key/history
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /authorize, token URL /oauth/token)

Path parameters

agent_idstring required

ID of the agent.

Example:agnt_6968b3984d1c238dbe7e2e29

Response

Successful Response

Example response

{
  "data": [
    {
      "action": "rotate",
      "actor_id": "usr_6968b3987ee4c3ec0b4ee3b9",
      "id": "aud_6968b3984275d71e90f7f09f",
      "occurred_at": "2026-01-20T14:00:00Z",
      "reason": "api_key_rotated"
    }
  ]
}

Changes