Update multiple FORM subfields by key in one request

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id}/fields \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "updates": [
    {
      "key": "<string>",
      "fieldMeta": "<unknown>"
    }
  ]
}
'

import requests

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

payload = { "updates": [
        {
            "key": "<string>",
            "fieldMeta": "<unknown>"
        }
    ] }
headers = {
    "authorization": "<authorization>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    authorization: '<authorization>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({updates: [{key: '<string>', fieldMeta: '<unknown>'}]})
};

fetch('https://app.sajn.se/api/v1/documents/{id}/fields', 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}/fields",
  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([
    'updates' => [
        [
                'key' => '<string>',
                'fieldMeta' => '<unknown>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$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}/fields"

	payload := strings.NewReader("{\n  \"updates\": [\n    {\n      \"key\": \"<string>\",\n      \"fieldMeta\": \"<unknown>\"\n    }\n  ]\n}")

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

	req.Header.Add("authorization", "<authorization>")
	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}/fields")
  .header("authorization", "<authorization>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"updates\": [\n    {\n      \"key\": \"<string>\",\n      \"fieldMeta\": \"<unknown>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["authorization"] = '<authorization>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"updates\": [\n    {\n      \"key\": \"<string>\",\n      \"fieldMeta\": \"<unknown>\"\n    }\n  ]\n}"

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

{
  "success": true,
  "updated": 123,
  "results": [
    {
      "key": "<string>",
      "success": true,
      "error": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "errorId": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "requiredScopes": [
    "<string>"
  ],
  "grantedScopes": [
    "<string>"
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "errorId": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "requiredScopes": [
    "<string>"
  ],
  "grantedScopes": [
    "<string>"
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "errorId": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "requiredScopes": [
    "<string>"
  ],
  "grantedScopes": [
    "<string>"
  ]
}

Document Fields

Update multiple FORM subfields by key in one request

Update several FORM subfield values by key in a single atomic request. Only DRAFT documents can have fields updated.

Use this instead of looping single-key PATCH .../fields/key:<key> calls. Because all FORM subfields share one underlying field row, concurrent single-key requests read-modify-write the same row and overwrite each other (lost updates). This endpoint applies all changes against one read per affected field, so nothing is clobbered.

Body:

PATCH /api/v1/documents/{docId}/fields
{
  "updates": [
    { "key": "name",  "fieldMeta": { "type": "input", "value": "Andreas" } },
    { "key": "phone", "fieldMeta": { "type": "input", "value": "070-1234567" } },
    { "key": "email", "fieldMeta": { "type": "input", "value": "[email protected]" } }
  ]
}

Each entry’s fieldMeta is merged into the existing subfield metadata (preserving label, placeholder, description, etc.), identical to the single-key endpoint. Max 50 updates per request.

Response: Returns a per-key result array so partial failures (e.g. an unknown key) are reported individually while valid updates still apply. success is true only when every update succeeded.

PATCH

api

documents

{id}

fields

Update multiple FORM subfields by key in one request

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id}/fields \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "updates": [
    {
      "key": "<string>",
      "fieldMeta": "<unknown>"
    }
  ]
}
'

import requests

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

payload = { "updates": [
        {
            "key": "<string>",
            "fieldMeta": "<unknown>"
        }
    ] }
headers = {
    "authorization": "<authorization>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {
    authorization: '<authorization>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({updates: [{key: '<string>', fieldMeta: '<unknown>'}]})
};

fetch('https://app.sajn.se/api/v1/documents/{id}/fields', 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}/fields",
  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([
    'updates' => [
        [
                'key' => '<string>',
                'fieldMeta' => '<unknown>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$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}/fields"

	payload := strings.NewReader("{\n  \"updates\": [\n    {\n      \"key\": \"<string>\",\n      \"fieldMeta\": \"<unknown>\"\n    }\n  ]\n}")

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

	req.Header.Add("authorization", "<authorization>")
	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}/fields")
  .header("authorization", "<authorization>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"updates\": [\n    {\n      \"key\": \"<string>\",\n      \"fieldMeta\": \"<unknown>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["authorization"] = '<authorization>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"updates\": [\n    {\n      \"key\": \"<string>\",\n      \"fieldMeta\": \"<unknown>\"\n    }\n  ]\n}"

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

{
  "success": true,
  "updated": 123,
  "results": [
    {
      "key": "<string>",
      "success": true,
      "error": "<string>"
    }
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "errorId": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "requiredScopes": [
    "<string>"
  ],
  "grantedScopes": [
    "<string>"
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "errorId": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "requiredScopes": [
    "<string>"
  ],
  "grantedScopes": [
    "<string>"
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "errorId": "<string>",
  "issues": [
    {
      "path": "<string>",
      "message": "<string>"
    }
  ],
  "requiredScopes": [
    "<string>"
  ],
  "grantedScopes": [
    "<string>"
  ]
}

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

string

required

Body

application/json

Body

updates

object[]

required

Array of field updates (max 50)

Required array length: 1 - 50 elements

Show child attributes

Response

200

success

boolean

required

Whether all updates succeeded

updated

number

required

Number of fields successfully updated

results

object[]

required

Per-field update results

Show child attributes

Overview

Login

System

Account

Workspaces

Members

Workspace Roles

Documents

Document Parties

Document Comments

Document Chat

Files

Folders

Blocks

Document Signers

Document Approval

Document Fields

Document Tags

Templates

Forms

Contacts

Companies

Tags

Document Categories

Custom Fields

Webhooks

Events

sajn ID

Organization

Helpers

API Reference

Update multiple FORM subfields by key in one request

Authorizations

Headers

Path Parameters

Body

Response