Update a document

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expiresAt": "2026-11-15T22:00:00.000Z",
  "documentMeta": {
    "message": "Hej Kai! Här är ditt anställningsavtal med det nya startdatumet."
  }
}
'

import requests

url = "https://app.sajn.se/api/v1/documents/{id}"

payload = {
    "expiresAt": "2026-11-15T22:00:00.000Z",
    "documentMeta": { "message": "Hej Kai! Här är ditt anställningsavtal med det nya startdatumet." }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    expiresAt: '2026-11-15T22:00:00.000Z',
    documentMeta: {message: 'Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.'}
  })
};

fetch('https://app.sajn.se/api/v1/documents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sajn.se/api/v1/documents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'expiresAt' => '2026-11-15T22:00:00.000Z',
    'documentMeta' => [
        'message' => 'Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sajn.se/api/v1/documents/{id}"

	payload := strings.NewReader("{\n  \"expiresAt\": \"2026-11-15T22:00:00.000Z\",\n  \"documentMeta\": {\n    \"message\": \"Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.\"\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://app.sajn.se/api/v1/documents/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"expiresAt\": \"2026-11-15T22:00:00.000Z\",\n  \"documentMeta\": {\n    \"message\": \"Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/documents/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"expiresAt\": \"2026-11-15T22:00:00.000Z\",\n  \"documentMeta\": {\n    \"message\": \"Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "cm4k2x9p10003abcd1234efgh",
  "externalId": "HR-2026-0142",
  "expiresAt": "2026-11-15T22:00:00.000Z",
  "name": "Anställningsavtal – Kai Lindqvist",
  "status": "DRAFT",
  "documentMeta": {
    "subject": "Ditt anställningsavtal från Exempelbolaget AB",
    "message": "Hej Kai! Här är ditt anställningsavtal. Signera det med BankID senast den 28 oktober.",
    "signingMode": "PARALLEL",
    "forceReadFullDocument": false,
    "showChatToSigners": false,
    "language": "sv",
    "value": "540000",
    "redirectUrl": null,
    "redirectEnabled": true,
    "internalRecipients": [
      "[email protected]"
    ],
    "signableAfterExpired": false,
    "sendPlainTextEmailOnly": false,
    "reminderIntervalDays": 3,
    "allowDelegation": false,
    "openVerification": "PIN",
    "aiChatEnabled": false,
    "nationalIdDisplayMode": "FULL",
    "sameDeviceSigning": false,
    "documentCategoryId": "cm4k2x9p10017abcd1234efgh"
  },
  "createdAt": "2026-09-28T09:12:00.000Z",
  "updatedAt": "2026-09-28T09:12:00.000Z",
  "completedAt": null,
  "deletedAt": null,
  "templateId": "cm4k2x9p10008abcd1234efgh",
  "folderId": "cm4k2x9p10011abcd1234efgh",
  "responsibleUserId": "cm4k2x9p10002abcd1234efgh",
  "parties": [
    {
      "id": "cm4k2x9p10004abcd1234efgh",
      "documentId": "cm4k2x9p10003abcd1234efgh",
      "email": "[email protected]",
      "name": "Kai Lindqvist",
      "phone": "+46701740605",
      "type": "INDIVIDUAL",
      "company": null,
      "externalId": "HR-2026-0142",
      "contactId": "cm4k2x9p10006abcd1234efgh",
      "nationalId": "191212121212",
      "country": "SE",
      "role": "SIGNER",
      "signingOrder": 1,
      "signedAt": "2026-09-29T07:41:00.000Z",
      "readStatus": "READ",
      "signingStatus": "SIGNED",
      "delivery": [
        "EMAIL"
      ],
      "signatureMethod": "SE_BANKID",
      "signVerification": "PIN",
      "openVerification": "PIN",
      "sendStatus": "DELIVERED",
      "identityVerified": true,
      "identityMismatch": false,
      "createdAt": "2026-09-28T09:12:00.000Z"
    }
  ],
  "tags": [
    {
      "id": "cm4k2x9p10010abcd1234efgh",
      "name": "Anställning",
      "color": "#16A34A"
    }
  ],
  "customFields": [
    {
      "id": "cm4k2x9p10016abcd1234efgh",
      "name": "Startdatum",
      "type": "TEXT",
      "value": "2026-11-01"
    }
  ],
  "content": [
    {
      "id": "cm4k2x9p10009abcd1234efgh",
      "documentId": "cm4k2x9p10003abcd1234efgh",
      "templateId": null,
      "type": "TEXT",
      "position": 0,
      "fieldMeta": {
        "type": "TEXT",
        "content": "<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>"
      },
      "createdAt": "2026-09-28T09:12:00.000Z",
      "updatedAt": "2026-09-28T09:12:00.000Z"
    }
  ],
  "productTables": [
    {
      "fieldId": "cm4k2x9p10009abcd1234efgh",
      "name": "Anställningsavtal – Kai Lindqvist",
      "currency": "SEK",
      "language": "sv",
      "allowSelection": false,
      "selectionPartyId": "cm4k2x9p10004abcd1234efgh",
      "selectionRequired": false,
      "sections": [
        {
          "id": "cm4k2x9p10037abcd1234efgh",
          "name": "Utbildningar",
          "pickOne": false
        }
      ],
      "rows": [
        {
          "id": "cm4k2x9p10036abcd1234efgh",
          "sku": "UTB-INTRO",
          "name": "Introduktionsutbildning",
          "description": "Introduktionsutbildning.",
          "unit": "st",
          "price": 4500,
          "vat": 25,
          "billing": "ONE_TIME",
          "discount": {
            "type": "PERCENT",
            "value": 1
          },
          "optional": false,
          "selected": false,
          "quantity": 1,
          "lineTotal": 1,
          "lineNet": 1,
          "lineVat": 1,
          "sectionId": "cm4k2x9p10037abcd1234efgh",
          "productType": "GOODS"
        }
      ],
      "totals": {
        "subtotal": 4500,
        "discountAmount": 1,
        "vatAmount": 1125,
        "total": 1,
        "rotDeduction": 1,
        "rutDeduction": 1,
        "payable": 5625,
        "byBilling": {
          "ONE_TIME": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          },
          "MONTHLY": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          },
          "QUARTERLY": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          },
          "YEARLY": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          }
        }
      }
    }
  ],
  "approvalRequestId": "cm4k2x9p10003abcd1234efgh",
  "bundleId": "cm4k2x9p10044abcd1234efgh"
}

{
  "code": "VALIDATION_FAILED",
  "message": "Invalid input: expected string, received number",
  "userMessage": "Förfrågan innehåller ogiltiga värden.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "issues": [
    {
      "path": "name",
      "code": "INVALID_TYPE",
      "message": "Invalid input: expected string, received number"
    }
  ]
}

{
  "code": "UNAUTHORIZED",
  "message": "Invalid API token",
  "userMessage": "Ogiltig API-nyckel",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "Insufficient OAuth scope: requires documents:write",
  "userMessage": "Applikationen saknar behörighet (scope) för denna åtgärd.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "requiredScopes": [
    "documents:write"
  ],
  "grantedScopes": [
    "profile:read"
  ]
}

{
  "code": "NOT_FOUND",
  "message": "Document not found",
  "userMessage": "Resursen hittades inte.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "resource": "document"
}

{
  "code": "INVALID_STATE",
  "message": "The resource's current state doesn't allow the operation, such as editing a document that was already sent or downloading a file that isn't produced yet.",
  "userMessage": "Åtgärden är inte möjlig i resursens nuvarande status.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "RATE_LIMITED",
  "message": "API rate limit exceeded",
  "userMessage": "För många förfrågningar. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INTERNAL_ERROR",
  "message": "Internal server error",
  "userMessage": "Något gick fel.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "UPSTREAM_UNAVAILABLE",
  "message": "A service the operation depends on, such as an eID provider or a connected integration, failed or is unavailable. Retry with exponential backoff.",
  "userMessage": "En extern tjänst svarar inte just nu. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

Documents

Update a document

Update document properties. A DRAFT document accepts every field. After sending, what you can change depends on the field, and a locked field returns 409 INVALID_STATE with the reason.

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, such as the subject, the message, and the signing mode
customFields - Custom field values

Per-party settings: Delivery method and signature type are set per party through the parties endpoints, not at the document level.

After sending:

name, externalId, responsibleUserId, value and documentCategoryId can always change.
Reminders, subject, message, redirect, chat, delegation, internal recipients and signableAfterExpired can change until the document is completed, cancelled or rejected.
expiresAt moves the deadline (at least 24 hours ahead) and notifies the parties, like POST /api/v1/documents/{id}/extend-expiration.
openVerification, forceReadFullDocument and language can change until someone has signed.
signingMode, nationalIdDisplayMode, sameDeviceSigning and documentStyle can’t change; withdraw the document first.

Response: Returns the updated document in the same shape as GET /api/v1/documents/{id}, without fields.

PATCH

api

documents

{id}

Update a document

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expiresAt": "2026-11-15T22:00:00.000Z",
  "documentMeta": {
    "message": "Hej Kai! Här är ditt anställningsavtal med det nya startdatumet."
  }
}
'

import requests

url = "https://app.sajn.se/api/v1/documents/{id}"

payload = {
    "expiresAt": "2026-11-15T22:00:00.000Z",
    "documentMeta": { "message": "Hej Kai! Här är ditt anställningsavtal med det nya startdatumet." }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    expiresAt: '2026-11-15T22:00:00.000Z',
    documentMeta: {message: 'Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.'}
  })
};

fetch('https://app.sajn.se/api/v1/documents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.sajn.se/api/v1/documents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'expiresAt' => '2026-11-15T22:00:00.000Z',
    'documentMeta' => [
        'message' => 'Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.sajn.se/api/v1/documents/{id}"

	payload := strings.NewReader("{\n  \"expiresAt\": \"2026-11-15T22:00:00.000Z\",\n  \"documentMeta\": {\n    \"message\": \"Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.\"\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://app.sajn.se/api/v1/documents/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"expiresAt\": \"2026-11-15T22:00:00.000Z\",\n  \"documentMeta\": {\n    \"message\": \"Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/documents/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"expiresAt\": \"2026-11-15T22:00:00.000Z\",\n  \"documentMeta\": {\n    \"message\": \"Hej Kai! Här är ditt anställningsavtal med det nya startdatumet.\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "cm4k2x9p10003abcd1234efgh",
  "externalId": "HR-2026-0142",
  "expiresAt": "2026-11-15T22:00:00.000Z",
  "name": "Anställningsavtal – Kai Lindqvist",
  "status": "DRAFT",
  "documentMeta": {
    "subject": "Ditt anställningsavtal från Exempelbolaget AB",
    "message": "Hej Kai! Här är ditt anställningsavtal. Signera det med BankID senast den 28 oktober.",
    "signingMode": "PARALLEL",
    "forceReadFullDocument": false,
    "showChatToSigners": false,
    "language": "sv",
    "value": "540000",
    "redirectUrl": null,
    "redirectEnabled": true,
    "internalRecipients": [
      "[email protected]"
    ],
    "signableAfterExpired": false,
    "sendPlainTextEmailOnly": false,
    "reminderIntervalDays": 3,
    "allowDelegation": false,
    "openVerification": "PIN",
    "aiChatEnabled": false,
    "nationalIdDisplayMode": "FULL",
    "sameDeviceSigning": false,
    "documentCategoryId": "cm4k2x9p10017abcd1234efgh"
  },
  "createdAt": "2026-09-28T09:12:00.000Z",
  "updatedAt": "2026-09-28T09:12:00.000Z",
  "completedAt": null,
  "deletedAt": null,
  "templateId": "cm4k2x9p10008abcd1234efgh",
  "folderId": "cm4k2x9p10011abcd1234efgh",
  "responsibleUserId": "cm4k2x9p10002abcd1234efgh",
  "parties": [
    {
      "id": "cm4k2x9p10004abcd1234efgh",
      "documentId": "cm4k2x9p10003abcd1234efgh",
      "email": "[email protected]",
      "name": "Kai Lindqvist",
      "phone": "+46701740605",
      "type": "INDIVIDUAL",
      "company": null,
      "externalId": "HR-2026-0142",
      "contactId": "cm4k2x9p10006abcd1234efgh",
      "nationalId": "191212121212",
      "country": "SE",
      "role": "SIGNER",
      "signingOrder": 1,
      "signedAt": "2026-09-29T07:41:00.000Z",
      "readStatus": "READ",
      "signingStatus": "SIGNED",
      "delivery": [
        "EMAIL"
      ],
      "signatureMethod": "SE_BANKID",
      "signVerification": "PIN",
      "openVerification": "PIN",
      "sendStatus": "DELIVERED",
      "identityVerified": true,
      "identityMismatch": false,
      "createdAt": "2026-09-28T09:12:00.000Z"
    }
  ],
  "tags": [
    {
      "id": "cm4k2x9p10010abcd1234efgh",
      "name": "Anställning",
      "color": "#16A34A"
    }
  ],
  "customFields": [
    {
      "id": "cm4k2x9p10016abcd1234efgh",
      "name": "Startdatum",
      "type": "TEXT",
      "value": "2026-11-01"
    }
  ],
  "content": [
    {
      "id": "cm4k2x9p10009abcd1234efgh",
      "documentId": "cm4k2x9p10003abcd1234efgh",
      "templateId": null,
      "type": "TEXT",
      "position": 0,
      "fieldMeta": {
        "type": "TEXT",
        "content": "<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>"
      },
      "createdAt": "2026-09-28T09:12:00.000Z",
      "updatedAt": "2026-09-28T09:12:00.000Z"
    }
  ],
  "productTables": [
    {
      "fieldId": "cm4k2x9p10009abcd1234efgh",
      "name": "Anställningsavtal – Kai Lindqvist",
      "currency": "SEK",
      "language": "sv",
      "allowSelection": false,
      "selectionPartyId": "cm4k2x9p10004abcd1234efgh",
      "selectionRequired": false,
      "sections": [
        {
          "id": "cm4k2x9p10037abcd1234efgh",
          "name": "Utbildningar",
          "pickOne": false
        }
      ],
      "rows": [
        {
          "id": "cm4k2x9p10036abcd1234efgh",
          "sku": "UTB-INTRO",
          "name": "Introduktionsutbildning",
          "description": "Introduktionsutbildning.",
          "unit": "st",
          "price": 4500,
          "vat": 25,
          "billing": "ONE_TIME",
          "discount": {
            "type": "PERCENT",
            "value": 1
          },
          "optional": false,
          "selected": false,
          "quantity": 1,
          "lineTotal": 1,
          "lineNet": 1,
          "lineVat": 1,
          "sectionId": "cm4k2x9p10037abcd1234efgh",
          "productType": "GOODS"
        }
      ],
      "totals": {
        "subtotal": 4500,
        "discountAmount": 1,
        "vatAmount": 1125,
        "total": 1,
        "rotDeduction": 1,
        "rutDeduction": 1,
        "payable": 5625,
        "byBilling": {
          "ONE_TIME": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          },
          "MONTHLY": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          },
          "QUARTERLY": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          },
          "YEARLY": {
            "subtotal": 4500,
            "vatAmount": 1125,
            "total": 1
          }
        }
      }
    }
  ],
  "approvalRequestId": "cm4k2x9p10003abcd1234efgh",
  "bundleId": "cm4k2x9p10044abcd1234efgh"
}

{
  "code": "VALIDATION_FAILED",
  "message": "Invalid input: expected string, received number",
  "userMessage": "Förfrågan innehåller ogiltiga värden.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "issues": [
    {
      "path": "name",
      "code": "INVALID_TYPE",
      "message": "Invalid input: expected string, received number"
    }
  ]
}

{
  "code": "UNAUTHORIZED",
  "message": "Invalid API token",
  "userMessage": "Ogiltig API-nyckel",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "Insufficient OAuth scope: requires documents:write",
  "userMessage": "Applikationen saknar behörighet (scope) för denna åtgärd.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "requiredScopes": [
    "documents:write"
  ],
  "grantedScopes": [
    "profile:read"
  ]
}

{
  "code": "NOT_FOUND",
  "message": "Document not found",
  "userMessage": "Resursen hittades inte.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "resource": "document"
}

{
  "code": "INVALID_STATE",
  "message": "The resource's current state doesn't allow the operation, such as editing a document that was already sent or downloading a file that isn't produced yet.",
  "userMessage": "Åtgärden är inte möjlig i resursens nuvarande status.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "RATE_LIMITED",
  "message": "API rate limit exceeded",
  "userMessage": "För många förfrågningar. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "INTERNAL_ERROR",
  "message": "Internal server error",
  "userMessage": "Något gick fel.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

{
  "code": "UPSTREAM_UNAVAILABLE",
  "message": "A service the operation depends on, such as an eID provider or a connected integration, failed or is unavailable. Retry with exponential backoff.",
  "userMessage": "En extern tjänst svarar inte just nu. Försök igen om en stund.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2"
}

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

Sajn-Workspace

string

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.

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

string

required

The document ID.

Body

application/json

Body

name

string

externalId

string | null

Your external reference ID for the document. Pass null to clear it.

expiresAt

string<date-time> | 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

string

required

Unique document identifier

externalId

string | null

required

Your external reference ID for this document

expiresAt

string<date-time> | null

required

Date and time when the document expires

name

string

required

Document name/title

status

enum<string>

required

Document status

Available options:

DRAFT,

PENDING_APPROVAL,

PENDING,

COMPLETED,

EXPIRED,

CANCELLED,

REJECTED,

IMPORTED

documentMeta

object | null

required

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

Show child attributes

createdAt

string<date-time>

required

Date and time when the document was created

updatedAt

string<date-time>

required

Date and time when the document was last updated

completedAt

string<date-time> | null

required

Date and time when all signers completed signing

deletedAt

string<date-time> | null

required

Date and time when the document moved to the trash, or null when it isn't in the trash

templateId

string | null

required

ID of the template the document was created from, or null

folderId

string | null

required

ID of the folder that holds the document, or null at the top level

responsibleUserId

string | null

required

ID of the workspace member responsible for the document

parties

object[]

required

Array of document parties (signers and other participants).

Show child attributes

Get started

Core concepts

Guides

Webhooks

API fundamentals

Upgrading

sajn Login

API reference

Update a document

Authorizations

Headers

Path Parameters

Body

Response