Managing Signers
Update and delete signers within a submission.
Managing Signers
GET
/api/v1/documents/{id}/submissions/{sid}/signersRequired scope:read:submissions
PUT
/api/v1/documents/{id}/submissions/{sid}/signers/{signerId}Update a signer's details
Required scope:write:submissions
DELETE
/api/v1/documents/{id}/submissions/{sid}/signers/{signerId}Remove a signer
Required scope:write:submissions
Update a signer
Use this to correct contact details or update expiry:
Request Body (all optional)
| Name | Type | Description |
|---|---|---|
| name | string | Update the signer's name |
| Update the signer's email | ||
| label | string | Display label |
| expiresAt | datetime | null | Update or clear the signing link expiry |
| password | string | null | Set or remove the signing link password |
curl -X PUT https://app.formalingo.com/api/v1/documents/DOC_ID/submissions/SUB_ID/signers/SIGNER_ID \
-H "Authorization: Bearer af_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "new-email@acme.com",
"expiresAt": "2026-04-30T23:59:59Z"
}'Remove a signer
curl -X DELETE https://app.formalingo.com/api/v1/documents/DOC_ID/submissions/SUB_ID/signers/SIGNER_ID \
-H "Authorization: Bearer af_live_YOUR_KEY"Note: Removing a signer that has already completed signing has no effect on the audit trail.