Skip to main content
POST
Reject a document
You’re viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To see the current version, select 2026-10 in the menu at the top of the sidebar. To move your integration, see Upgrading to 2026-10.

Authorizations

Authorization
string
header
required

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

Headers

authorization
string
required

Bearer token for API authentication

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

Path Parameters

id
string
required

Body

application/json

Body

Reject a document

comment
string
required

Required comment explaining why the document was rejected

Minimum string length: 1

Response

Document approval status

Document approval status

id
string
required

Approval ID

documentId
string
required

Document ID

status
enum<string>
required

Overall approval status, derived from the chain: REJECTED if any step was rejected, PENDING if any step is still pending, otherwise APPROVED

Available options:
PENDING,
APPROVED,
REJECTED
autoSend
boolean
required

Whether the document is sent automatically once the chain fully approves

approvers
object[]
required

The ordered approval chain

requestedBy
object
required

The user who submitted for approval

customMessage
string | null
required

Custom message for signing invitation

createdAt
any
required

When the approval was requested