Revoke an agent and every key it holds
POST
/v1/organisations/{id}/agents/{agentId}/revokeOperation 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"