Update document signatory
update-document-signatoryDestructiveIdempotent
Edit the details of a document signatory.
Use this tool when:
A signatory's name, title, mobile phone, or party assignment needs to change before signing starts
You need to move an existing signatory to a different party on the document
document_uuid and signatory_email are required to identify the signatory. All other arguments are optional and only need to be sent if their value should change. For internal signatories (linked to an account user), signatory_first_name, signatory_last_name, and signatory_title cannot be changed — they come from the user's profile.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"document_uuid": "<document_uuid>",
"signatory_email": "<signatory_email>"
},
"name": "update-document-signatory"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| document_uuid | Yes | UUID of the document where the signatory is being updated. If you don't already have the document's UUID, use the list-documents tool to find it. | |
| signatory_email | Yes | Email address of the signatory to update. | |
| signatory_title | No | New job title. Cannot be changed if internal_user is true | |
| signatory_last_name | No | Signatory's new last name. Cannot be changed if internal_user is true | |
| signatory_first_name | No | Signatory's new first name. Cannot be changed if internal_user is true | |
| signatory_mobile_phone | No | New mobile phone number in E.164 format. Depending on the document's signature_type, may be required before signing can be started | |
| signatory_party_identifier | No | If given, moves the signatory to this party. Must be a ref_uuid, reference, or entity_name of an existing party in the document |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name of the signatory | |
| uuid | No | Do not show to the user unless they ask for it | |
| No | Email of the signatory | ||
| party_uuid | No | UUID of the party this signatory belongs to. Absent if the signatory has not been assigned to a party yet, which prevents signing from being started. Do not show to the user unless they ask for it | |
| _entity_type | No | Only relevant for tooling. Do not show to the user | |
| internal_user | No | true if the signatory has a fynk user in this account | |
| signing_order | No | The order in which this signatory signs |