Documentation Index
Fetch the complete documentation index at: https://docs.imarobot.ai/llms.txt
Use this file to discover all available pages before exploring further.
Revoke an agent immediately. Subsequent verifications return TOKEN_REVOKED.
Request
POST /v1/agents/:id/revoke
Authorization: Bearer sk_live_YOUR_KEY
Content-Type: application/json
{
"reason": "Credential rotation"
}
| Field | Type | Required | Description |
|---|
reason | string | — | Optional. Stored in the audit log. |
Response
{
"revoked": true,
"agent_id": "agt_abc123",
"revoked_at": "2026-03-26T18:00:00.000Z",
"reason": "Credential rotation"
}
