Skip to Content

Publish a form

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/forms/{id}/publish

Validate readiness and publish or reopen the form. The authenticated user becomes the sender of future documents and must be allowed to create and send documents without approval. Plan, signing methods, expiry and capacity are checked. Requires forms:write and documents:write.

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Path Parameters

id*string

Header Parameters

authorization*string

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.

Lengthlength <= 255

Response Body

200

application/json
  1. response
id*string
templateId*string
workspaceId*string
senderUserId*string
respondentSignerId*string|null
url*string
enabled*boolean
closedReason*|
Value in"INCOMPLETE""MAX_SUBMISSIONS""EXPIRED""SENDER_LEFT"
hasPassword*boolean
title*string|null
description*string|null
thankYouMessage*string|null
redirectUrl*string|null
documentExpiresInDays*number
expiresAt*string|null
maxSubmissions*number|null
submissionCount*number
createdAt*string
updatedAt*string
questions*array<||||||>
Itemsitems <= 60
slots*array<>
publishIssues*array<>
statistics*
Example Request
curl -X POST 'https://app.sajn.se/api/v1/forms/string/publish' \  -H 'authorization: string'
Example Response
{  "id": "string",  "templateId": "string",  "workspaceId": "string",  "senderUserId": "string",  "respondentSignerId": "string",  "url": "string",  "enabled": true,  "closedReason": "INCOMPLETE",  "hasPassword": true,  "title": "string",  "description": "string",  "thankYouMessage": "string",  "redirectUrl": "string",  "documentExpiresInDays": 0,  "expiresAt": "string",  "maxSubmissions": 0,  "submissionCount": 0,  "createdAt": "string",  "updatedAt": "string",  "questions": [    {      "id": "string",      "label": "string",      "placeholder": "string",      "description": "string",      "width": "full",      "required": true,      "kind": "name"    }  ],  "slots": [    {      "key": "string",      "label": "string",      "type": "string",      "required": true,      "options": [        "string"      ]    }  ],  "publishIssues": [    {      "code": "string",      "severity": "blocker",      "message": "string"    }  ],  "statistics": {    "started": 0,    "signed": 0  }}

Was this page helpful?