ReferenceAPI referenceAgents
Revoke an agent's access with its refresh token
Revoke an agent's access with its refresh token: CustomDomain™ API reference in the agents group. Covers parameters, request body, responses and error codes.
RFC 7009. Revokes the grant behind a refresh token, so the agent's access ends within one access token lifetime (15 minutes at most). It answers 200 for a token it does not know, so it cannot be used to find out which tokens exist, and for a refresh token that was already replaced or revoked, which revokes nothing. Send the client's client_id with the token. The workspace's owners and admins are told once.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/oauth/agent/revoke" \ -H "Content-Type: application/json" \ -d '{ "token": "string" }'Empty
{ "error": "string", "error_description": "string"}{ "error": "string", "error_description": "string"}