Correct a party's contact details
Corrects the email address or phone number of a party in an OPEN bundle, on every document they haven't signed yet, and sends them a fresh invitation. A new email address gets a new link, and the old one stops working. This is the one change a sent bundle takes.
To change anything else, withdraw the bundle with POST /api/v1/bundles/{id}/withdraw, change it, and send it again. On a DRAFT bundle, use PUT /api/v1/bundles/{id}/parties.
Permission required: EDIT_DOCUMENT on the workspace, and access to every document in the bundle. Requires a Team plan.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
id*stringThe bundle ID.
partyId*stringThe party ID.
Sajn-Version?stringAPI version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.
"2026-09""2026-10"Sajn-Workspace?stringID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.
Idempotency-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 <= 255Body
application/json- body
email?stringThe corrected email address. The party gets a new link and a fresh invitation, and the old link stops working.
^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$emailphone?|The corrected phone number. Pass null to clear it.
200
application/json- response
id*stringThe party ID.
name*|The bundle name, shown as the heading of the bundle page and in the invitation.
status*stringDRAFT while you build it, and again after a withdraw. OPEN from the send until every document is resolved, then COMPLETED. CANCELED after a cancel.
"DRAFT""OPEN""COMPLETED""CANCELED"subject*|The subject line of the invitation email.
message*|A message included in every invitation.
expiresAt*|The expiry date of the bundle. Every document in it gets the same one.
date-timesigningMode*stringHow the parties sign: PARALLEL, all at once, or SEQUENTIAL, one at a time in the order of each party's signingOrder. The order runs across every document in the bundle.
"PARALLEL""SEQUENTIAL"language*stringLanguage of the bundle page and the emails to the parties, an ISO 639-1 code such as sv.
"sv""en""no""da""fi""de""is""es""fr""it"reminderIntervalDays*|Days between automatic reminders. 0 turns them off, and null uses the default of 3.
-9007199254740991 <= value <= 9007199254740991signableAfterExpired*booleanWhether the documents can still be signed after expiresAt.
internalRecipients*array<string>Email addresses that receive a copy of each sealed PDF once its document is completed.
nationalIdDisplayMode*|How national identity numbers are displayed to signers: FULL, PARTIAL, or NONE. null keeps each document's own setting.
"FULL""PARTIAL""NONE"nullopenVerification*|Verification every party passes before the document opens: PIN, SMS, EMAIL, or an eID such as SE_BANKID. null means none. A party's own openVerification overrides it.
"PIN""SMS""EMAIL""SE_BANKID""NO_BANKID_BIOMETRIC""NO_BANKID_HIGH""DK_MITID""DK_MITID_ERHVERV""FI_FTN""NL_IDIN"nullsendPlainTextEmailOnly*|Send plain text invitations only, without HTML. null inherits the workspace default.
redirectUrl*|URL to send a party to once they have signed.
redirectEnabled*booleanWhether redirectUrl is used.
documentCount*integerThe number of documents in documents.
-9007199254740991 <= value <= 9007199254740991createdAt*stringWhen the party was created.
date-timeupdatedAt*stringWhen the party was last updated.
date-timedocuments*array<>The documents in the bundle, oldest first.
parties*array<>The bundle's parties, in signing order.
curl -X PATCH 'https://app.sajn.se/api/v1/bundles/cm4k2x9p10044abcd1234efgh/parties/cm4k2x9p10004abcd1234efgh' \ -H 'Content-Type: application/json' \ -d '{ "email": "kai.lindqvist@example.com"}'{ "id": "cm4k2x9p10004abcd1234efgh", "name": "Kai Lindqvist", "status": "OPEN", "subject": "Ditt anställningsavtal från Exempelbolaget AB", "message": "Hej Kai! Här är ditt anställningsavtal. Signera det med BankID senast den 28 oktober.", "expiresAt": "2026-10-28T22:00:00.000Z", "signingMode": "PARALLEL", "language": "sv", "reminderIntervalDays": 3, "signableAfterExpired": false, "internalRecipients": [ "hr@example.com" ], "nationalIdDisplayMode": "FULL", "openVerification": "PIN", "sendPlainTextEmailOnly": false, "redirectUrl": null, "redirectEnabled": true, "documentCount": 1, "createdAt": "2026-09-28T09:12:00.000Z", "updatedAt": "2026-09-28T09:15:00.000Z", "documents": [ { "id": "cm4k2x9p10003abcd1234efgh", "name": "Anställningsavtal – Kai Lindqvist", "status": "COMPLETED", "parties": [ { "id": "cm4k2x9p10004abcd1234efgh", "bundlePartyId": "cm4k2x9p10004abcd1234efgh", "name": "Kai Lindqvist", "email": "kai@example.com", "role": "SIGNER", "signingStatus": "SIGNED", "signedAt": "2026-09-29T07:41:00.000Z" } ] } ], "parties": [ { "id": "cm4k2x9p10004abcd1234efgh", "name": "Kai Lindqvist", "email": "kai@example.com", "phone": "+46701740605", "role": "SIGNER", "signingOrder": 1, "delivery": [ "EMAIL" ], "signatureMethod": "SE_BANKID", "signVerification": "PIN", "openVerification": "PIN", "status": "PENDING", "documentIds": [ "cm4k2x9p10003abcd1234efgh" ] } ]}Was this page helpful?