CustomDomain Docs
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.

POST
/oauth/agent/revoke

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.

Request Body

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"}