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
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.
header
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
id*stringIdempotency-Key?stringMakes 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.
Length
length <= 255200
application/json- response
id*stringtemplateId*stringworkspaceId*stringsenderUserId*stringrespondentSignerId*string|nullurl*stringenabled*booleanclosedReason*|Value in
"INCOMPLETE""MAX_SUBMISSIONS""EXPIRED""SENDER_LEFT"hasPassword*booleantitle*string|nulldescription*string|nullthankYouMessage*string|nullredirectUrl*string|nulldocumentExpiresInDays*numberexpiresAt*string|nullmaxSubmissions*number|nullsubmissionCount*numbercreatedAt*stringupdatedAt*stringquestions*array<||||||>Items
items <= 60slots*array<>publishIssues*array<>statistics*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?