Cancel signature request
Cancels a request that is waiting for signatures.
MCP tool yousign_write → cancel_signature_request
write Confirm
Works on a request in Approval or In progress. Participants are notified and can no longer open the signature page, and a cancelled request cannot be reactivated. The documents stay downloadable and the request can be duplicated. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| signature_request_id string required | string | Signature request ID from list_signature_requests or create_signature_request. |
| reason string required | string | The reason, chosen from the list Yousign offers under Cancel request. |
| message string | string | Optional custom message shown to the signers. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yousign_write",
"arguments": {
"operation": "cancel_signature_request",
"arguments": {
"signature_request_id": "signature_request_8c41d2",
"reason": "reason"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"id": "2a7f9e10-3b4c-4d85-a6e1-7c90d2b8f351",
"name": "Lease renewal",
"status": "Cancelled",
"reason": "Terms changed",
"notified": 2
},
"isError": false
}