Request approval of a document
Submits a DRAFT document for internal approval. The document’s status changes to PENDING_APPROVAL, and sajn notifies the approvers of the first stage. When the request is approved, sajn sends the document for signing, unless approvers already on the document were set up with autoSend false.
Pass approverIds to set who approves; every one of them must approve. Omit it to submit the approvers already on the document, such as the ones its template adds. A template that locks its approvers returns 409 INVALID_STATE if you pass approverIds.
To resubmit a rejected request, call this endpoint again. The request keeps its ID, and every approver’s decision is reset, so earlier decisions aren’t kept. The resubmission fires approval_request.created again, with the same data.object.id.
Permission required: SEND_DOCUMENT on the workspace.
Authorizations
Headers
ID 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.
Body
Body
Request internal approval of a document
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.
11Response
An internal approval request for a document
An internal approval request for a document
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 
