Revoke Oauth Grant

DELETE /oauth/grants/{grant_id}

Effective on the client’s next call. 204 either way: an id that is not the caller’s must not be confirmed to exist (annex 05 §5.2).

Role floor

Requires viewer or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Parameters

Name	In	Type		Notes
grant_id	path	string (uuid)	required	—

Responses

Status	Description	Body
204	Successful Response	—
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X DELETE https://your-deployment.example.com/oauth/grants/{grant_id} \
  -H "Authorization: Bearer $COBRE_TOKEN"