Replace form document parties
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
Replace the complete party list. Include IDs to retain parties; omit IDs to create them. Omitted properties on retained parties, including their PIN, stay unchanged. Null clears nullable properties. Missing parties are deleted. If the respondent is removed, select another SIGNER before publishing. Existing submissions are unchanged. 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
parties*array<>Items
1 <= items <= 100200
application/json- response
parties*array<>curl -X PUT 'https://app.sajn.se/api/v1/forms/string/document/parties' \ -H 'authorization: string' \ -H 'Content-Type: application/json' \ -d '{ "parties": [ { "name": "string" } ]}'Example Response
{ "parties": [ { "id": "string", "templateId": "string", "name": "string", "email": "string", "phone": "string", "type": "INDIVIDUAL", "role": "SIGNER", "signingOrder": 0, "contactId": "string", "companyId": "string", "companyName": "string", "companyRole": "string", "companyOrgNumber": "string", "externalId": "string", "ssn": "string", "country": "string", "requiredSignature": "NONE", "deliveryMethod": "EMAIL", "twoStepVerification": "NONE", "createdAt": null, "updatedAt": null } ]}Was this page helpful?