Update a party

Update party information. Most fields can only be updated before the document is sent.

Updatable Fields:

• name - Party’s full name
• email - Party’s email address
• phone - Party’s phone number
• companyName - Company name
• companyRole - Role within company
• companyOrgNumber - Company organization number
• companyId - Link to existing company
• ssn - Swedish personal number (for BankID)
• role - Party role (SIGNER, ORGANIZER, REVIEWER, ACCEPTOR)
• signingOrder - Order for sequential signing
• deliveryMethod - How to notify: EMAIL, SMS, or NONE
• requiredSignature - Signature type: DRAWING, BANKID, or CLICK_TO_SIGN
• twoStepVerification - 2FA: NONE or SMS_BEFORE_SIGNING

Restrictions: Cannot update after party has signed the document.

PATCH /api/v1/documents/{id}/parties/{partyId}

Update a party

cURL

curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id}/parties/{partyId} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "role": "SIGNER",
  "name": "<string>",
  "email": "[e-mail]",
  "phone": "<string>",
  "companyName": "<string>",
  "companyRole": "<string>",
  "companyOrgNumber": "<string>",
  "externalId": "<string>",
  "companyId": "<string>",
  "ssn": "<string>",
  "country": "<string>",
  "signingOrder": 123
}
'

200

{
  "id": "<string>",
  "documentId": "<string>",
  "name": "<string>",
  "signedAt": "<string>",
  "email": "[e-mail]",
  "phone": "<string>",
  "companyName": "<string>",
  "companyRole": "<string>",
  "companyOrgNumber": "<string>",
  "externalId": "<string>",
  "companyId": "<string>",
  "ssn": "<string>",
  "country": "<string>",
  "signingOrder": 123
}

Headers

authorization · string · required

Bearer token for API authentication

Path Parameters

id · string · required

partyId · string · required

Body

application/json

Body

role · enum<string> · default: SIGNER · required

Available options: SIGNER, ORGANIZER, REVIEWER, ACCEPTOR

name · string

email · string<email>

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

phone · string

companyName · string

companyRole · string

companyOrgNumber · string

externalId · string

companyId · string

ssn · string

country · string

ISO 3166-1 alpha-3 country code for the signer (e.g. SWE, USA, DEU)

signingOrder · number | null

deliveryMethod · enum<string>

How to send to this signer: EMAIL, SMS, or NONE

Available options: EMAIL, SMS, NONE

requiredSignature · enum<string>

Signature type required: DRAWING, BANKID, or CLICK_TO_SIGN

Available options: NONE, DRAWING, BANKID, MANUAL, CLICK_TO_SIGN

twoStepVerification · enum<string>

Two-step verification: NONE or SMS_BEFORE_SIGNING

Available options: NONE, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING

Response

200

application/json

200

id · string · required

Unique signer identifier

documentId · string · required

Document ID this signer belongs to

name · string · required

Signer full name

role · enum<string> · required

Signer role: SIGNER, ORGANIZER, REVIEWER, or ACCEPTOR

Available options: SIGNER, ORGANIZER, REVIEWER, ACCEPTOR

signedAt · string | null · required

Date and time when the signer signed (null if not signed)

readStatus · enum<string> · required

Read status: NOT_OPENED, OPENED, or READ

Available options: NOT_OPENED, OPENED, READ

signingStatus · enum<string> · required

Signing status: NOT_SIGNED, SIGNED, or REJECTED

Available options: NOT_SIGNED, SIGNED, REJECTED

deliveryMethod · enum<string> | null · required

How documents are sent to this signer: EMAIL, SMS, or NONE

Available options: EMAIL, SMS, NONE

requiredSignature · enum<string> | null · required

Signature type required: DRAWING, BANKID, CLICK_TO_SIGN, etc.

Available options: NONE, DRAWING, BANKID, MANUAL, CLICK_TO_SIGN

twoStepVerification · enum<string> | null · required

Two-step verification: NONE or SMS_BEFORE_SIGNING

Available options: NONE, SMS_BEFORE_SIGNING, EMAIL_BEFORE_SIGNING

sendStatus · enum<string> | null · required

Send status: NOT_SENT, SENT, DELIVERED, BOUNCED, or FAILED

Available options: NOT_SENT, SENT, DELIVERED, BOUNCED, FAILED

email · string<email> | null

Signer email address

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

phone · string | null

Signer phone number (for SMS notifications)

companyName · string | null

Company name

companyRole · string | null

Role/title within the company

companyOrgNumber · string | null

Company organization number

externalId · string | null

Your external reference ID for this signer

companyId · string | null

Linked company ID

ssn · string | null

Swedish personal number (personnummer) - required for BankID signing

country · string | null

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

signingOrder · number | null

Order for sequential signing (null for parallel)