Revoke agentic identities | API Reference

POST

/v1/mgmt/agentic/identities/revoke

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

userId?string

clientId?string

resourceId?string

consentId?string

Revoke agentic identities and their consents by client ID, consent ID, resource ID and/or user ID, using a valid management key. A request with only a user ID revokes all of the user's agentic identities across MCP servers.

curl -X POST "https://api.descope.com/v1/mgmt/agentic/identities/revoke" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.descope.com/v1/mgmt/agentic/identities/revoke" \  -H "Content-Type: application/json" \  -d '{}'

ResponseOK

{
  "revoked": 0
}

{  "revoked": 0}

TypeScript

export interface Response {
revoked?: number
}

export interface Response {revoked?: number}

Was this helpful?