Skip to main content
PATCH
/
api
/
v1
/
documents
/
{id}
/
signers
/
{signerId}
Update a signer
curl --request PATCH \
  --url https://app.sajn.se/api/v1/documents/{id}/signers/{signerId} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "name": "<string>",
  "email": "jsmith@example.com",
  "phone": "<string>",
  "companyName": "<string>",
  "companyRole": "<string>",
  "companyOrgNumber": "<string>",
  "externalId": "<string>",
  "companyId": "<string>",
  "ssn": "<string>",
  "role": "SIGNER",
  "signingOrder": 123
}'
{
  "id": "<string>",
  "documentId": "<string>",
  "email": "jsmith@example.com",
  "name": "<string>",
  "phone": "<string>",
  "companyName": "<string>",
  "companyRole": "<string>",
  "companyOrgNumber": "<string>",
  "externalId": "<string>",
  "companyId": "<string>",
  "ssn": "<string>",
  "role": "SIGNER",
  "signingOrder": 123,
  "token": "<string>",
  "signedAt": "<any>",
  "readStatus": "NOT_OPENED",
  "signingStatus": "NOT_SIGNED",
  "signingUrl": "<string>"
}

Headers

authorization
string
required

Bearer token for API authentication

Path Parameters

id
string
required
signerId
string
required

Body

application/json

Body

role
enum<string>
default:SIGNER
required
Available options:
SIGNER,
ORGANIZER,
REVIEWER,
ACCEPTOR
name
string
email
string<email>
phone
string
companyName
string
companyRole
string
companyOrgNumber
string
externalId
string
companyId
string
ssn
string
signingOrder
number | null

Response

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
token
string
required

Unique signing token

signedAt
any
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
signingUrl
string
required

Complete signing URL for this signer

email
string<email> | null

Signer email address

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

signingOrder
number | null

Order for sequential signing (null for parallel)

I