Revoke one Agent consent record owned by the current Admin.

DELETE

/api/admin/me/agent-consents/{id}

Code sample: Shell / cURL

curl --request DELETE \
  --url https://auth.example.com/api/admin/me/agent-consents/example \
  --header 'Authorization: Bearer <token>'

Delegation withdrawal suspends the Grant. OAuth client withdrawal leaves the Grant active and revokes only that client consent and token families. Both paths synchronously commit an outbox record and audit evidence.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

id

required

string

Responses

200

Consent revoked.

Media type application/json

object

consent_id

required

string

consent_type

required

string

Allowed values: delegation oauth_client

grant_status

required

string

Allowed values: active suspended

token_families_pending_revocation

required

integer

key

additional properties

Example

{
  "consent_type": "delegation",
  "grant_status": "active"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}