Skip to main content
POST
Request approval of a document

Authorizations

Authorization
string
header
required

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Headers

Sajn-Version
enum<string>

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.

Available options:
2026-09,
2026-10
Idempotency-Key
string

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.

Maximum string length: 255

Body

application/json

Body

Request internal approval of a document

documentId
string
required

ID of a DRAFT document

Minimum string length: 1
approverIds
string[]

User IDs of the approvers. Every one of them must approve, in any order. Omit it to submit the approvers already on the document, such as the ones its template adds. To list members who can approve, call GET /api/v1/members?permission=APPROVE_DOCUMENT.

Minimum array length: 1
Minimum string length: 1
customMessage
string

Message to include in the signing invitation when the approved document is sent. Requires approverIds.

Response

An internal approval request for a document

An internal approval request for a document

id
string
required

Approval request ID

documentId
string
required

The document ID.

status
enum<string>
required

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.

Available options:
DRAFT,
PENDING,
APPROVED,
REJECTED,
CANCELLED
autoSend
boolean
required

If true, sajn sends the document for signing when the request is approved. If false, the document waits for you to send it.

customMessage
string | null
required

The message included in the signing invitation when the document is sent

requestedBy
object
required

The user who submitted the request

approvers
object[]
required

The approvers, ordered by stage

createdAt
string<date-time>
required

When the approval was created.

updatedAt
string<date-time>
required

When the approval was last updated.