Revoke group
Revokes every member token that is not already REVOKED. Revocation is permanent. The action is applied in the background to the tokens that are members when the call is made; tokens added later are not affected. Members whose status the action does not apply to are counted in skipped.
Requires the emsp:tokens:write scope.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
- Token URL
- https://auth.spirii.dk/realms/public-api/protocol/openid-connect/token
Headers
Client-generated unique key per operation intent (UUID). Same key + identical body replays the original response; same key + different body returns 409.
Path Parameters
The token group group_id
Body
Free-text reason, recorded on the history event of each token the action changes
500"Card reported lost"
Response
The operation was accepted
Identifies this background operation
ACTIVATE, SUSPEND, REACTIVATE, REVOKE Progress of the operation
PENDING, IN_PROGRESS, COMPLETED, FAILED Member tokens when the action was requested
x >= 0Members whose status the action applies to
x >= 0Eligible members the action has been applied to
x >= 0Eligible members the action failed on
x >= 0Members whose status the action does not apply to; total minus eligible
x >= 0The members the action failed on. Absent until the operation has processed tokens
When the operation reached COMPLETED or FAILED; null until then