Skip to the page

Revoke an agent and every key it holds

POST/v1/organisations/{id}/agents/{agentId}/revoke

Operation agents.revoke · since 2026-11-10 · beta

Needs a session withwritescopeAnswers200 OK

`{ "revoked": true }`: every key it holds ends.

Owners, admins, or the person it acts for.

Path parameters

idstring (uuid)required
The organisation id.
agentIdstringrequired
The agent.

Body

None. Send no body, or an empty JSON object.

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer.

POST/v1/organisations/{id}/agents/{agentId}/revoke
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/agents/$AGENT_ID/revoke" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN"