Revoke a linked identity
DELETE/v1/assistant/grants/:grant_id
Revokes the grant, disabling the Assistant for that identity. The grant is resolved on every inbound message, so the next one from that identity is refused before the agent is invoked — revocation is immediate, not eventual. Work the grant started (a paused generation) calls no tool on its next step. The identity is free to link again afterwards.
Request
Responses
- 204
- 401
- 403
- 404
- 502
Grant revoked.
Missing or invalid credentials.
FORBIDDEN: the credential is confined to one project. Account routes need an account-wide credential.
The resource does not exist (existence is not leaked).
UPSTREAM_UNAVAILABLE: the runtime did not record the revocation, so the grant stays active. Retry.