Cancel a request

Closes a request that has not yet been decided.

Permitted for the requester, or an administrator or owner of the organization. The two produce different final statuses, so the audit trail reads correctly either way.

cancelled_by must be active. Someone who has left, been suspended or been archived cannot cancel — not even their own request, which they could not withdraw in Zluri either — and is refused with 400 USER_NOT_ACTIVE. To close out a departed person’s request, name an administrator or owner instead.

Only a pending request can be cancelled, so this can never revoke access that has already been granted. Cancelling a closed request returns INVALID_STATE_TRANSITION.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The request's request_id (REQ-1042) or its id — both are accepted.

Body Params
string
required
^[a-fA-F0-9]{24}$

Zluri user id.

string
length between 1 and 400

Why the request is being cancelled. Recorded with the cancellation.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json