Skip to Content

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
/api/v1/forms/{id}/document/parties

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.

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

Request Body

Body

application/json
  1. body
parties*array<>
Items1 <= items <= 100

Response Body

200

application/json
  1. response
parties*array<>
Example Request
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?