Update a document content block

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id}/content/{contentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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>",
    "locked": false,
    "sectionStyle": {
      "background": "NONE",
      "padding": "NONE",
      "bleed": false,
      "border": false
    },
    "hidden": false
  }
}
'

import requests

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

payload = {
    "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>",
        "locked": False,
        "sectionStyle": {
            "background": "NONE",
            "padding": "NONE",
            "bleed": False,
            "border": False
        },
        "hidden": False
    }
}
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({
    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>',
      locked: false,
      sectionStyle: {background: 'NONE', padding: 'NONE', bleed: false, border: false},
      hidden: false
    }
  })
};

fetch('https://app.sajn.se/api/v1/documents/{id}/content/{contentId}', 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}/content/{contentId}",
  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([
    '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>',
        'locked' => false,
        'sectionStyle' => [
                'background' => 'NONE',
                'padding' => 'NONE',
                'bleed' => false,
                'border' => false
        ],
        'hidden' => false
    ]
  ]),
  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}/content/{contentId}"

	payload := strings.NewReader("{\n  \"type\": \"TEXT\",\n  \"position\": 0,\n  \"fieldMeta\": {\n    \"type\": \"TEXT\",\n    \"content\": \"<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>\",\n    \"locked\": false,\n    \"sectionStyle\": {\n      \"background\": \"NONE\",\n      \"padding\": \"NONE\",\n      \"bleed\": false,\n      \"border\": false\n    },\n    \"hidden\": false\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}/content/{contentId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"TEXT\",\n  \"position\": 0,\n  \"fieldMeta\": {\n    \"type\": \"TEXT\",\n    \"content\": \"<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>\",\n    \"locked\": false,\n    \"sectionStyle\": {\n      \"background\": \"NONE\",\n      \"padding\": \"NONE\",\n      \"bleed\": false,\n      \"border\": false\n    },\n    \"hidden\": false\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"type\": \"TEXT\",\n  \"position\": 0,\n  \"fieldMeta\": {\n    \"type\": \"TEXT\",\n    \"content\": \"<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>\",\n    \"locked\": false,\n    \"sectionStyle\": {\n      \"background\": \"NONE\",\n      \"padding\": \"NONE\",\n      \"bleed\": false,\n      \"border\": false\n    },\n    \"hidden\": false\n  }\n}"

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

{
  "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"
}

{
  "code": "VALIDATION_FAILED",
  "message": "Invalid input: expected string, received number",
  "userMessage": "Förfrågan innehåller ogiltiga värden.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "issues": [
    {
      "path": "type",
      "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": "Content block not found",
  "userMessage": "Resursen hittades inte.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "resource": "field"
}

{
  "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"
}

Document content

Update a document content block

Updates a document field by its ID. Only DRAFT documents can be changed. To fill in a value, such as a FORM subfield, use PATCH /api/v1/documents/{id}/field-values instead. To find the field that holds a key, call GET /api/v1/documents/{id}/content?key=KEY.

Updatable properties:

type - Field type
position - Field order
fieldMeta - The full metadata for the field type, which replaces the stored metadata

The following example updates an HTML field:

PATCH /api/v1/documents/{docId}/content/{contentId}
{
  "type": "HTML",
  "fieldMeta": {
    "type": "HTML",
    "content": "<div style='text-align: center'><h1>Contract title</h1><p>Custom styled content</p></div>"
  }
}

The response is the updated field, in the same shape as GET /api/v1/documents/{id}/content/{contentId}.

PATCH

api

documents

{id}

content

{contentId}

Update a document content block

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id}/content/{contentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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>",
    "locked": false,
    "sectionStyle": {
      "background": "NONE",
      "padding": "NONE",
      "bleed": false,
      "border": false
    },
    "hidden": false
  }
}
'

import requests

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

payload = {
    "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>",
        "locked": False,
        "sectionStyle": {
            "background": "NONE",
            "padding": "NONE",
            "bleed": False,
            "border": False
        },
        "hidden": False
    }
}
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({
    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>',
      locked: false,
      sectionStyle: {background: 'NONE', padding: 'NONE', bleed: false, border: false},
      hidden: false
    }
  })
};

fetch('https://app.sajn.se/api/v1/documents/{id}/content/{contentId}', 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}/content/{contentId}",
  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([
    '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>',
        'locked' => false,
        'sectionStyle' => [
                'background' => 'NONE',
                'padding' => 'NONE',
                'bleed' => false,
                'border' => false
        ],
        'hidden' => false
    ]
  ]),
  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}/content/{contentId}"

	payload := strings.NewReader("{\n  \"type\": \"TEXT\",\n  \"position\": 0,\n  \"fieldMeta\": {\n    \"type\": \"TEXT\",\n    \"content\": \"<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>\",\n    \"locked\": false,\n    \"sectionStyle\": {\n      \"background\": \"NONE\",\n      \"padding\": \"NONE\",\n      \"bleed\": false,\n      \"border\": false\n    },\n    \"hidden\": false\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}/content/{contentId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"TEXT\",\n  \"position\": 0,\n  \"fieldMeta\": {\n    \"type\": \"TEXT\",\n    \"content\": \"<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>\",\n    \"locked\": false,\n    \"sectionStyle\": {\n      \"background\": \"NONE\",\n      \"padding\": \"NONE\",\n      \"bleed\": false,\n      \"border\": false\n    },\n    \"hidden\": false\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"type\": \"TEXT\",\n  \"position\": 0,\n  \"fieldMeta\": {\n    \"type\": \"TEXT\",\n    \"content\": \"<p>Anställningen gäller tills vidare från och med den 1 november 2026, med sex månaders provanställning.</p>\",\n    \"locked\": false,\n    \"sectionStyle\": {\n      \"background\": \"NONE\",\n      \"padding\": \"NONE\",\n      \"bleed\": false,\n      \"border\": false\n    },\n    \"hidden\": false\n  }\n}"

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

{
  "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"
}

{
  "code": "VALIDATION_FAILED",
  "message": "Invalid input: expected string, received number",
  "userMessage": "Förfrågan innehåller ogiltiga värden.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "issues": [
    {
      "path": "type",
      "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": "Content block not found",
  "userMessage": "Resursen hittades inte.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "resource": "field"
}

{
  "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.

contentId

string

required

The content block ID.

Body

application/json

Body

type

enum<string>

Field type

Available options:

TEXT,

HTML,

FORM,

PDF,

PRODUCT_TABLE,

TABLE,

SPACER,

PAGE_BREAK,

DURATION

position

number

0-based order of the field among the content blocks

fieldMeta

object

The full metadata for the field type. It replaces the stored metadata.

Show child attributes

Response

200

string

required

Unique field identifier

documentId

string | null

required

Document this field belongs to

templateId

string | null

required

Template this field belongs to

type

enum<string>

required

Field type

Available options:

TEXT,

HTML,

FORM,

PDF,

PRODUCT_TABLE,

TABLE,

SPACER,

PAGE_BREAK,

DURATION

position

number

required

0-based order of the field among the document's content blocks

fieldMeta

object

required

Type-specific content. For PDF fields this includes placedFields (boxes placed on the PDF pages) and formFields (form fields extracted from the PDF).

Show child attributes

createdAt

string<date-time> | null

required

Date and time when the field was created

updatedAt

string<date-time> | null

required

Date and time when the field was last updated

Get started

Core concepts

Guides

Webhooks

API fundamentals

Upgrading

sajn Login

API reference

Update a document content block

Authorizations

Headers

Path Parameters

Body

Response