Select the respondent party
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.PUT
Choose an existing SIGNER from this form's document. The visitor fills this party's slot. Invalid edits close a published form. Requires forms:write and documents:write, including for drafts.
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 <= 255Body
application/json- body
signerId*stringLength
1 <= length200
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 PUT 'https://app.sajn.se/api/v1/forms/string/respondent' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{ "signerId": "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?