Approve an approval request
Approves the request as the authenticated user, who must be an approver in the current stage. You can't approve on someone else's behalf. When the last required approver approves, the request becomes APPROVED, and with autoSend set to true, sajn sends the document for signing.
Permission required: APPROVE_DOCUMENT on the workspace.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe approval ID.
Sajn-Version?stringAPI 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"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Idempotency-Key?stringMakes 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.
length <= 255Body
application/json- body
Approve a document
comment?stringOptional comment from the approver
An internal approval request for a document
application/json- response
An internal approval request for a document
id*stringApproval request ID
documentId*stringThe document ID.
status*stringDRAFT 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"autoSend*booleanIf true, sajn sends the document for signing when the request is approved. If false, the document waits for you to send it.
customMessage*|The message included in the signing invitation when the document is sent
requestedBy*The user who submitted the request
approvers*array<>The approvers, ordered by stage
createdAt*stringWhen the approval was created.
date-timeupdatedAt*stringWhen the approval was last updated.
date-timecurl -X POST 'https://app.sajn.se/api/v1/approval-requests/cm4k2x9p10029abcd1234efgh/approve' \ -H 'Content-Type: application/json' \ -d '{ "comment": "Godkänt enligt lönepolicyn."}'{ "id": "cm4k2x9p10029abcd1234efgh", "documentId": "cm4k2x9p10003abcd1234efgh", "status": "APPROVED", "autoSend": false, "customMessage": "Påminnelse: signera ditt anställningsavtal senast den 28 oktober.", "requestedBy": { "id": "cm4k2x9p10002abcd1234efgh", "email": "alex@example.com", "name": "Alex Berg" }, "approvers": [ { "user": { "id": "cm4k2x9p10002abcd1234efgh", "email": "alex@example.com", "name": "Alex Berg" }, "stage": 1, "orGroup": "Quinn Holm", "status": "APPROVED", "comment": "Godkänt enligt lönepolicyn.", "resolvedAt": "2026-09-29T07:41:00.000Z" } ], "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:15:00.000Z"}Was this page helpful?