Cancel an approval request
Cancels a PENDING request. Only the user who submitted it can cancel it. sajn deletes the request, so the response is the last state of the request with status set to CANCELLED, and GET /api/v1/approval-requests/{id} returns 404 afterwards. The approval_request.cancelled event carries the same last state, so it’s the only record of the request. The document returns to DRAFT.
Permission required: SEND_DOCUMENT on the workspace.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
2026-09, 2026-10 Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
255Path Parameters
The approval ID.
Body
Body
The body is of type object.
Response
An internal approval request for a document
An internal approval request for a document
Approval request ID
The document ID.
DRAFT while the document is a draft and the request isn't submitted, such as approvers a template added or a request whose document was withdrawn; PENDING while it waits for approvers; APPROVED once every stage approves; REJECTED after any approver rejects; CANCELLED only in the response to the cancel request and in the approval_request.cancelled event, because a cancelled request is deleted.
DRAFT, PENDING, APPROVED, REJECTED, CANCELLED If true, sajn sends the document for signing when the request is approved. If false, the document waits for you to send it.
The message included in the signing invitation when the document is sent
The user who submitted the request
The approvers, ordered by stage
When the approval was created.
When the approval was last updated.

