Update form settings and questions

curl --request PATCH \
  --url https://app.sajn.se/api/v1/forms/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Intresseanmälan",
  "description": "Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.",
  "thankYouMessage": "Tack! Vi återkommer inom två arbetsdagar.",
  "redirectUrl": null,
  "password": null,
  "questions": [
    {
      "id": "name",
      "kind": "NAME",
      "label": "Namn",
      "required": true
    },
    {
      "id": "email",
      "kind": "EMAIL",
      "label": "E-post",
      "required": true
    },
    {
      "id": "startdatum",
      "kind": "FIELD",
      "key": "startdatum",
      "label": "Önskat startdatum",
      "required": true
    }
  ],
  "expiresAt": "2026-10-28T22:00:00.000Z",
  "maxSubmissions": 100,
  "documentExpiresInDays": 30
}
'

import requests

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

payload = {
    "name": "Intresseanmälan",
    "description": "Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.",
    "thankYouMessage": "Tack! Vi återkommer inom två arbetsdagar.",
    "redirectUrl": None,
    "password": None,
    "questions": [
        {
            "id": "name",
            "kind": "NAME",
            "label": "Namn",
            "required": True
        },
        {
            "id": "email",
            "kind": "EMAIL",
            "label": "E-post",
            "required": True
        },
        {
            "id": "startdatum",
            "kind": "FIELD",
            "key": "startdatum",
            "label": "Önskat startdatum",
            "required": True
        }
    ],
    "expiresAt": "2026-10-28T22:00:00.000Z",
    "maxSubmissions": 100,
    "documentExpiresInDays": 30
}
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({
    name: 'Intresseanmälan',
    description: 'Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.',
    thankYouMessage: 'Tack! Vi återkommer inom två arbetsdagar.',
    redirectUrl: null,
    password: null,
    questions: [
      {id: 'name', kind: 'NAME', label: 'Namn', required: true},
      {id: 'email', kind: 'EMAIL', label: 'E-post', required: true},
      {
        id: 'startdatum',
        kind: 'FIELD',
        key: 'startdatum',
        label: 'Önskat startdatum',
        required: true
      }
    ],
    expiresAt: '2026-10-28T22:00:00.000Z',
    maxSubmissions: 100,
    documentExpiresInDays: 30
  })
};

fetch('https://app.sajn.se/api/v1/forms/{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/forms/{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([
    'name' => 'Intresseanmälan',
    'description' => 'Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.',
    'thankYouMessage' => 'Tack! Vi återkommer inom två arbetsdagar.',
    'redirectUrl' => null,
    'password' => null,
    'questions' => [
        [
                'id' => 'name',
                'kind' => 'NAME',
                'label' => 'Namn',
                'required' => true
        ],
        [
                'id' => 'email',
                'kind' => 'EMAIL',
                'label' => 'E-post',
                'required' => true
        ],
        [
                'id' => 'startdatum',
                'kind' => 'FIELD',
                'key' => 'startdatum',
                'label' => 'Önskat startdatum',
                'required' => true
        ]
    ],
    'expiresAt' => '2026-10-28T22:00:00.000Z',
    'maxSubmissions' => 100,
    'documentExpiresInDays' => 30
  ]),
  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/forms/{id}"

	payload := strings.NewReader("{\n  \"name\": \"Intresseanmälan\",\n  \"description\": \"Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.\",\n  \"thankYouMessage\": \"Tack! Vi återkommer inom två arbetsdagar.\",\n  \"redirectUrl\": null,\n  \"password\": null,\n  \"questions\": [\n    {\n      \"id\": \"name\",\n      \"kind\": \"NAME\",\n      \"label\": \"Namn\",\n      \"required\": true\n    },\n    {\n      \"id\": \"email\",\n      \"kind\": \"EMAIL\",\n      \"label\": \"E-post\",\n      \"required\": true\n    },\n    {\n      \"id\": \"startdatum\",\n      \"kind\": \"FIELD\",\n      \"key\": \"startdatum\",\n      \"label\": \"Önskat startdatum\",\n      \"required\": true\n    }\n  ],\n  \"expiresAt\": \"2026-10-28T22:00:00.000Z\",\n  \"maxSubmissions\": 100,\n  \"documentExpiresInDays\": 30\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/forms/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Intresseanmälan\",\n  \"description\": \"Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.\",\n  \"thankYouMessage\": \"Tack! Vi återkommer inom två arbetsdagar.\",\n  \"redirectUrl\": null,\n  \"password\": null,\n  \"questions\": [\n    {\n      \"id\": \"name\",\n      \"kind\": \"NAME\",\n      \"label\": \"Namn\",\n      \"required\": true\n    },\n    {\n      \"id\": \"email\",\n      \"kind\": \"EMAIL\",\n      \"label\": \"E-post\",\n      \"required\": true\n    },\n    {\n      \"id\": \"startdatum\",\n      \"kind\": \"FIELD\",\n      \"key\": \"startdatum\",\n      \"label\": \"Önskat startdatum\",\n      \"required\": true\n    }\n  ],\n  \"expiresAt\": \"2026-10-28T22:00:00.000Z\",\n  \"maxSubmissions\": 100,\n  \"documentExpiresInDays\": 30\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/forms/{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  \"name\": \"Intresseanmälan\",\n  \"description\": \"Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.\",\n  \"thankYouMessage\": \"Tack! Vi återkommer inom två arbetsdagar.\",\n  \"redirectUrl\": null,\n  \"password\": null,\n  \"questions\": [\n    {\n      \"id\": \"name\",\n      \"kind\": \"NAME\",\n      \"label\": \"Namn\",\n      \"required\": true\n    },\n    {\n      \"id\": \"email\",\n      \"kind\": \"EMAIL\",\n      \"label\": \"E-post\",\n      \"required\": true\n    },\n    {\n      \"id\": \"startdatum\",\n      \"kind\": \"FIELD\",\n      \"key\": \"startdatum\",\n      \"label\": \"Önskat startdatum\",\n      \"required\": true\n    }\n  ],\n  \"expiresAt\": \"2026-10-28T22:00:00.000Z\",\n  \"maxSubmissions\": 100,\n  \"documentExpiresInDays\": 30\n}"

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

{
  "id": "cm4k2x9p10023abcd1234efgh",
  "templateId": "cm4k2x9p10008abcd1234efgh",
  "workspaceId": "cm4k2x9p10001abcd1234efgh",
  "sender": {
    "id": "cm4k2x9p10002abcd1234efgh",
    "email": "[email protected]",
    "name": "Alex Berg"
  },
  "respondentPartyId": "cm4k2x9p10035abcd1234efgh",
  "url": "https://app.sajn.se/f/Xk9mQ2vR7tLp4wZs8nYb3",
  "enabled": true,
  "closedReason": null,
  "hasPassword": false,
  "name": "Intresseanmälan",
  "description": "Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.",
  "thankYouMessage": "Tack! Vi återkommer inom två arbetsdagar.",
  "redirectUrl": null,
  "documentExpiresInDays": 30,
  "expiresAt": "2026-10-28T22:00:00.000Z",
  "maxSubmissions": 100,
  "submissionCount": 12,
  "createdAt": "2026-09-28T09:12:00.000Z",
  "updatedAt": "2026-09-28T09:15:00.000Z",
  "questions": [
    {
      "id": "name",
      "kind": "NAME",
      "label": "Namn",
      "required": true
    },
    {
      "id": "email",
      "kind": "EMAIL",
      "label": "E-post",
      "required": true
    },
    {
      "id": "startdatum",
      "kind": "FIELD",
      "key": "startdatum",
      "label": "Önskat startdatum",
      "required": true
    }
  ],
  "slots": [
    {
      "key": "startdatum",
      "label": "Startdatum",
      "type": "DATEPICKER",
      "required": true,
      "options": null
    }
  ],
  "publishIssues": [],
  "statistics": {
    "started": 14,
    "signed": 12
  }
}

{
  "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 forms:write, documents:write",
  "userMessage": "Applikationen saknar behörighet (scope) för denna åtgärd.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "requiredScopes": [
    "forms:write",
    "documents:write"
  ],
  "grantedScopes": [
    "profile:read"
  ]
}

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

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

PATCH

api

forms

{id}

Update form settings and questions

curl --request PATCH \
  --url https://app.sajn.se/api/v1/forms/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Intresseanmälan",
  "description": "Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.",
  "thankYouMessage": "Tack! Vi återkommer inom två arbetsdagar.",
  "redirectUrl": null,
  "password": null,
  "questions": [
    {
      "id": "name",
      "kind": "NAME",
      "label": "Namn",
      "required": true
    },
    {
      "id": "email",
      "kind": "EMAIL",
      "label": "E-post",
      "required": true
    },
    {
      "id": "startdatum",
      "kind": "FIELD",
      "key": "startdatum",
      "label": "Önskat startdatum",
      "required": true
    }
  ],
  "expiresAt": "2026-10-28T22:00:00.000Z",
  "maxSubmissions": 100,
  "documentExpiresInDays": 30
}
'

import requests

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

payload = {
    "name": "Intresseanmälan",
    "description": "Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.",
    "thankYouMessage": "Tack! Vi återkommer inom två arbetsdagar.",
    "redirectUrl": None,
    "password": None,
    "questions": [
        {
            "id": "name",
            "kind": "NAME",
            "label": "Namn",
            "required": True
        },
        {
            "id": "email",
            "kind": "EMAIL",
            "label": "E-post",
            "required": True
        },
        {
            "id": "startdatum",
            "kind": "FIELD",
            "key": "startdatum",
            "label": "Önskat startdatum",
            "required": True
        }
    ],
    "expiresAt": "2026-10-28T22:00:00.000Z",
    "maxSubmissions": 100,
    "documentExpiresInDays": 30
}
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({
    name: 'Intresseanmälan',
    description: 'Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.',
    thankYouMessage: 'Tack! Vi återkommer inom två arbetsdagar.',
    redirectUrl: null,
    password: null,
    questions: [
      {id: 'name', kind: 'NAME', label: 'Namn', required: true},
      {id: 'email', kind: 'EMAIL', label: 'E-post', required: true},
      {
        id: 'startdatum',
        kind: 'FIELD',
        key: 'startdatum',
        label: 'Önskat startdatum',
        required: true
      }
    ],
    expiresAt: '2026-10-28T22:00:00.000Z',
    maxSubmissions: 100,
    documentExpiresInDays: 30
  })
};

fetch('https://app.sajn.se/api/v1/forms/{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/forms/{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([
    'name' => 'Intresseanmälan',
    'description' => 'Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.',
    'thankYouMessage' => 'Tack! Vi återkommer inom två arbetsdagar.',
    'redirectUrl' => null,
    'password' => null,
    'questions' => [
        [
                'id' => 'name',
                'kind' => 'NAME',
                'label' => 'Namn',
                'required' => true
        ],
        [
                'id' => 'email',
                'kind' => 'EMAIL',
                'label' => 'E-post',
                'required' => true
        ],
        [
                'id' => 'startdatum',
                'kind' => 'FIELD',
                'key' => 'startdatum',
                'label' => 'Önskat startdatum',
                'required' => true
        ]
    ],
    'expiresAt' => '2026-10-28T22:00:00.000Z',
    'maxSubmissions' => 100,
    'documentExpiresInDays' => 30
  ]),
  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/forms/{id}"

	payload := strings.NewReader("{\n  \"name\": \"Intresseanmälan\",\n  \"description\": \"Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.\",\n  \"thankYouMessage\": \"Tack! Vi återkommer inom två arbetsdagar.\",\n  \"redirectUrl\": null,\n  \"password\": null,\n  \"questions\": [\n    {\n      \"id\": \"name\",\n      \"kind\": \"NAME\",\n      \"label\": \"Namn\",\n      \"required\": true\n    },\n    {\n      \"id\": \"email\",\n      \"kind\": \"EMAIL\",\n      \"label\": \"E-post\",\n      \"required\": true\n    },\n    {\n      \"id\": \"startdatum\",\n      \"kind\": \"FIELD\",\n      \"key\": \"startdatum\",\n      \"label\": \"Önskat startdatum\",\n      \"required\": true\n    }\n  ],\n  \"expiresAt\": \"2026-10-28T22:00:00.000Z\",\n  \"maxSubmissions\": 100,\n  \"documentExpiresInDays\": 30\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/forms/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Intresseanmälan\",\n  \"description\": \"Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.\",\n  \"thankYouMessage\": \"Tack! Vi återkommer inom två arbetsdagar.\",\n  \"redirectUrl\": null,\n  \"password\": null,\n  \"questions\": [\n    {\n      \"id\": \"name\",\n      \"kind\": \"NAME\",\n      \"label\": \"Namn\",\n      \"required\": true\n    },\n    {\n      \"id\": \"email\",\n      \"kind\": \"EMAIL\",\n      \"label\": \"E-post\",\n      \"required\": true\n    },\n    {\n      \"id\": \"startdatum\",\n      \"kind\": \"FIELD\",\n      \"key\": \"startdatum\",\n      \"label\": \"Önskat startdatum\",\n      \"required\": true\n    }\n  ],\n  \"expiresAt\": \"2026-10-28T22:00:00.000Z\",\n  \"maxSubmissions\": 100,\n  \"documentExpiresInDays\": 30\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.sajn.se/api/v1/forms/{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  \"name\": \"Intresseanmälan\",\n  \"description\": \"Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.\",\n  \"thankYouMessage\": \"Tack! Vi återkommer inom två arbetsdagar.\",\n  \"redirectUrl\": null,\n  \"password\": null,\n  \"questions\": [\n    {\n      \"id\": \"name\",\n      \"kind\": \"NAME\",\n      \"label\": \"Namn\",\n      \"required\": true\n    },\n    {\n      \"id\": \"email\",\n      \"kind\": \"EMAIL\",\n      \"label\": \"E-post\",\n      \"required\": true\n    },\n    {\n      \"id\": \"startdatum\",\n      \"kind\": \"FIELD\",\n      \"key\": \"startdatum\",\n      \"label\": \"Önskat startdatum\",\n      \"required\": true\n    }\n  ],\n  \"expiresAt\": \"2026-10-28T22:00:00.000Z\",\n  \"maxSubmissions\": 100,\n  \"documentExpiresInDays\": 30\n}"

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

{
  "id": "cm4k2x9p10023abcd1234efgh",
  "templateId": "cm4k2x9p10008abcd1234efgh",
  "workspaceId": "cm4k2x9p10001abcd1234efgh",
  "sender": {
    "id": "cm4k2x9p10002abcd1234efgh",
    "email": "[email protected]",
    "name": "Alex Berg"
  },
  "respondentPartyId": "cm4k2x9p10035abcd1234efgh",
  "url": "https://app.sajn.se/f/Xk9mQ2vR7tLp4wZs8nYb3",
  "enabled": true,
  "closedReason": null,
  "hasPassword": false,
  "name": "Intresseanmälan",
  "description": "Anmäl ditt intresse för en tjänst hos Exempelbolaget AB.",
  "thankYouMessage": "Tack! Vi återkommer inom två arbetsdagar.",
  "redirectUrl": null,
  "documentExpiresInDays": 30,
  "expiresAt": "2026-10-28T22:00:00.000Z",
  "maxSubmissions": 100,
  "submissionCount": 12,
  "createdAt": "2026-09-28T09:12:00.000Z",
  "updatedAt": "2026-09-28T09:15:00.000Z",
  "questions": [
    {
      "id": "name",
      "kind": "NAME",
      "label": "Namn",
      "required": true
    },
    {
      "id": "email",
      "kind": "EMAIL",
      "label": "E-post",
      "required": true
    },
    {
      "id": "startdatum",
      "kind": "FIELD",
      "key": "startdatum",
      "label": "Önskat startdatum",
      "required": true
    }
  ],
  "slots": [
    {
      "key": "startdatum",
      "label": "Startdatum",
      "type": "DATEPICKER",
      "required": true,
      "options": null
    }
  ],
  "publishIssues": [],
  "statistics": {
    "started": 14,
    "signed": 12
  }
}

{
  "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 forms:write, documents:write",
  "userMessage": "Applikationen saknar behörighet (scope) för denna åtgärd.",
  "requestId": "req_V1StGXR8Z5jdHi6BmyT2",
  "requiredScopes": [
    "forms:write",
    "documents:write"
  ],
  "grantedScopes": [
    "profile:read"
  ]
}

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

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

Body

application/json

Body

name

string | null

Name of the form, shown as the heading of the public form page.

Maximum string length: 200

description

string | null

Introduction shown under the heading.

Maximum string length: 4000

thankYouMessage

string | null

Message shown after the respondent submits.

Maximum string length: 4000

redirectUrl

string<uri> | null

http(s) URL the respondent goes to after submitting, in place of the thank-you message.

Maximum string length: 2000

password

string | null

Omit to keep the password, null to remove it, or a string to replace it.

Required string length: 4 - 100

questions

object[]

The complete ordered question list. Replaces the current list.

Maximum array length: 60

Show child attributes

expiresAt

string<date-time> | null

When the form closes to new submissions. Null keeps it open.

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

maxSubmissions

integer | null

Most submissions the form accepts, counting active starts and submitted responses. Null means no limit.

Required range: 1 <= x <= 100000

documentExpiresInDays

integer

Days each document created from a submission stays signable.

Required range: 1 <= x <= 3650

Response

200

string

required

The form ID.

templateId

string

required

The ID of the template the form owns. Its documents are created from it.

workspaceId

string

required

The workspace ID.

sender

object

required

The member every document from the form is created and sent as.

Show child attributes

respondentPartyId

string | null

required

The ID of the template party the respondent becomes. Null on a draft without one.

url

string

required

The public form link.

enabled

boolean

required

True if the form is published.

closedReason

enum<string> | null

required

Why a published form stopped accepting submissions. Null while it's open.

Available options:

INCOMPLETE,

MAX_SUBMISSIONS,

EXPIRED,

SENDER_LEFT,

null

hasPassword

boolean

required

True if the link requires a password.

name

string | null

required

Name of the form, shown as the heading of the public form page.

description

string | null

required

Introduction shown under the heading.

thankYouMessage

string | null

required

Message shown after the respondent submits.

redirectUrl

string | null

required

URL the respondent goes to after submitting.

documentExpiresInDays

number

required

Days each document created from a submission stays signable.

expiresAt

string<date-time> | null

required

When the form closes to new submissions. Null keeps it open.

maxSubmissions

number | null

required

Most submissions the form accepts. Null means no limit.

submissionCount

number

required

Active starts plus submitted responses, counted against maxSubmissions.

createdAt

string<date-time>

required

When the form was created.

updatedAt

string<date-time>

required

When the form was last updated.

questions

object[]

required

Maximum array length: 60

Show child attributes

slots

object[]

required

The keyed FORM subfields of the form's document that a FIELD question can fill.

Show child attributes

publishIssues

object[]

required

What stops the form from publishing (BLOCKER) or deserves a look (WARNING). Empty when the form is ready.

Show child attributes

statistics

object

required

Show child attributes

Get started

Core concepts

Guides

Webhooks

API fundamentals

Upgrading

sajn Login

API reference

Update form settings and questions

Authorizations

Headers

Path Parameters

Body

Response