Skip to Content

Update a template 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.
PATCH
/api/v1/templates/{id}/parties/{partyId}

Update an existing template party.

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

id*string
partyId*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

Update template party request

name?string
email?string
Match^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Formatemail
phone?string
companyName?string
companyRole?string
companyOrgNumber?string
companyId?string
externalId?string
ssn?string
country?string

ISO 3166-1 alpha-3 country code (e.g. SWE)

role?unknown

Party role: SIGNER, ORGANIZER, or REVIEWER. (ACCEPTOR is deprecated and treated as SIGNER.)

signingOrder?number|null
deliveryMethod?string
Value in"EMAIL""SMS""NONE""IN_APP"
requiredSignature?string
Value in"NONE""DRAWING""SE_BANKID""MANUAL""CLICK_TO_SIGN""NO_BANKID_BIOMETRIC""NO_BANKID_HIGH""NO_QES""DK_MITID""DK_MITID_ERHVERV""FI_FTN""NL_IDIN"
twoStepVerification?string
Value in"NONE""SMS_BEFORE_SIGNING""EMAIL_BEFORE_SIGNING""PIN_BEFORE_SIGNING""SE_BANKID_BEFORE_SIGNING""NO_BANKID_BIOMETRIC_BEFORE_SIGNING""NO_BANKID_HIGH_BEFORE_SIGNING""DK_MITID_BEFORE_SIGNING""DK_MITID_ERHVERV_BEFORE_SIGNING""FI_FTN_BEFORE_SIGNING""NL_IDIN_BEFORE_SIGNING"

Response Body

200

application/json
  1. response
id*string

Unique template party identifier

templateId*string

Template ID this party belongs to

name*string

Party name

email?|

Party email address

phone?|

Party phone number

type*string

Party type: INDIVIDUAL or COMPANY

Value in"INDIVIDUAL""COMPANY"
role*string

Party role: SIGNER, ORGANIZER, or REVIEWER

Value in"SIGNER""ORGANIZER""REVIEWER"
signingOrder?|

Order for sequential signing

contactId?|

Linked contact ID

companyId?|

Linked company ID

companyName?|

Company name

companyRole?|

Role within the company

companyOrgNumber?|

Company organization number

externalId?|

External reference ID

ssn?|

Swedish personal number (personnummer)

country?|

ISO 3166-1 alpha-3 country code (e.g. SWE)

requiredSignature?|

Default required signature type

Value in"NONE""DRAWING""BANKID""MANUAL""CLICK_TO_SIGN""NO_BANKID_BIOMETRIC""NO_BANKID_HIGH""NO_QES""DK_MITID""DK_MITID_ERHVERV""FI_FTN""NL_IDIN"
deliveryMethod*string

Default delivery method

Value in"EMAIL""SMS""NONE""IN_APP"
twoStepVerification*string

Default two-step verification

Value in"NONE""PIN_BEFORE_SIGNING""SMS_BEFORE_SIGNING""EMAIL_BEFORE_SIGNING""BANKID_BEFORE_SIGNING""NO_BANKID_BIOMETRIC_BEFORE_SIGNING""NO_BANKID_HIGH_BEFORE_SIGNING""DK_MITID_BEFORE_SIGNING""DK_MITID_ERHVERV_BEFORE_SIGNING""FI_FTN_BEFORE_SIGNING""NL_IDIN_BEFORE_SIGNING"
createdAt*unknown
updatedAt*unknown
Example Request
curl -X PATCH 'https://app.sajn.se/api/v1/templates/string/parties/string' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "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?