Update a document

Update document properties. Only DRAFT documents can have all fields updated. Sent documents have restrictions.

Updatable Fields:

• name - Document title
• externalId - Your external reference ID
• expiresAt - Document expiration date
• responsibleUserId - User ID of responsible team member (must be in your organization)
• documentMeta - Metadata including subject, message, and signing order
• customFields - Custom field values

Per-Signer Settings: Delivery method and signature type are configured per-signer via the signers endpoint, not at the document level.

Note: Some fields like signing order cannot be modified after the document is sent.

PATCH /api/v1/documents/{id}

Update a document

cURL

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>",
  "externalId": "<string>",
  "expiresAt": "<string>",
  "responsibleUserId": "<string>",
  "documentMeta": {
    "subject": "<string>",
    "message": "<string>",
    "forceReadFullDocument": true,
    "showChatToSigners": true,
    "value": "<string>",
    "redirectUrl": "<string>",
    "redirectEnabled": true
  },
  "documentStyle": {
    "paddingEnabled": true,
    "backgroundColor": "<string>",
    "backgroundOpacity": 0.5,
    "backgroundImageUrl": "<string>",
    "backgroundImageOpacity": 0.5
  },
  "customFields": [
    {
      "customInputId": "<string>",
      "value": "<string>"
    }
  ]
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "externalId": "<string>",
  "expiresAt": "<string>",
  "documentMeta": {
    "subject": "<string>",
    "message": "<string>",
    "forceReadFullDocument": true,
    "showChatToSigners": true,
    "value": "<string>",
    "redirectUrl": "<string>",
    "redirectEnabled": true
  },
  "completedAt": "<string>"
}

Headers

authorization · string · required

Bearer token for API authentication

Path Parameters

id · string · required

Body

application/json

Body

name · string

externalId · string

expiresAt · string | null

responsibleUserId · string

User ID of the person responsible for this document. Must be a member of your organization.

documentMeta · object

Show child attributes

documentStyle · object

Document styling configuration including orientation, padding, background, and layout

Show child attributes

customFields · object[]

Show child attributes

Response

200

application/json

200

id · string · required

Unique document identifier

name · string · required

Document name/title

status · string · required

Document status: DRAFT, SENDING, PENDING, COMPLETED, EXPIRED, CANCELLED, or IMPORTED

createdAt · any · required

Date and time when the document was created

updatedAt · any · required

Date and time when the document was last updated

externalId · string | null

Your external reference ID for this document

expiresAt · string | null

Date and time when the document expires

documentMeta · object

Document metadata including subject, message, signing order, etc.

Show child attributes

completedAt · string | null

Date and time when all signers completed signing