Skip to main content
POST
Revoke Superseded Grants

Authorizations

Authorization
string
header
required

A token from the identity provider your deployment federates with. It identifies a person; their roles in the workspace decide what they may do.

Body

application/json

Revoke every grant a newer one has replaced and that was never used.

reason
string
required
Required string length: 20 - 2000
dry_run
boolean
default:false
agent_id
string | null
expected
integer | null
Required range: x >= 0

Response

Successful Response

matched
integer
required
revoked
integer
required
dry_run
boolean
required
rule
string
required
audit_event_id
string | null