---
name: "esign_cancel"
area: "esign"
title: "Cancel a signature request"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/esign_cancel"
mcp_server: "https://api.conecto.chat/mcp/esign"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/esign/esign_cancel"
---

# Cancel a signature request (`esign_cancel`)

Stops a request before everyone has signed; signers are told and their links stop working.

Stop a request before everyone has signed. Signers who were asked get a short email saying nothing is needed any more; their links stop working.

Price: Free. A call that fails costs nothing.

## Use it when

The document changed or the deal fell through.

## Say this to your agent

> Cancel the signature request for the old trade agreement. We're sending a corrected version.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `request_id` | string | yes | The request_id esign_send returned. Exactly 36 characters. |  |  |
| `reason` | string | no | Up to 300 characters. |  |  |

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `esign_cancel` on the MCP server `https://api.conecto.chat/mcp/esign` with these arguments:

```json
{
  "request_id": "1b3d5f7a-9c1e-4d3f-8a5b-7d9f1b3d5e8c",
  "reason": "A corrected version follows"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/esign_cancel \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_id": "1b3d5f7a-9c1e-4d3f-8a5b-7d9f1b3d5e8c", "reason": "A corrected version follows"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "esign_cancel",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "request_id": "1b3d5f7a-9c1e-4d3f-8a5b-7d9f1b3d5e8c",
    "title": "Trade account agreement",
    "status": "cancelled",
    "order": "parallel",
    "sent_at": "2026-10-14T08:00:00+00:00",
    "expires_at": "2026-11-13T08:00:00+00:00",
    "completed_at": null,
    "document_file_id": "af1f9fa7-7426-4920-9ca4-9efea08e7ab0",
    "signers": [
      {
        "position": 1,
        "name": "Jana Weber",
        "email": "jana@weber-kuechenplanung.example",
        "status": "pending",
        "viewed_at": null,
        "signed_at": null,
        "decline_reason": null
      }
    ]
  }
}
```

`result`: The request, now cancelled.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No signature request of the business has that request_id. | Find it with esign_list. |
| `closed` | 409 | The request is completed, declined, cancelled or expired. | Send a new request if needed. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [esign_send](https://conecto.chat/tools/esign/esign_send.md): Sends a PDF from the file store to up to 10 people to sign; each gets their own link by email. $0.50 a call.
- [esign_save_template](https://conecto.chat/tools/esign/esign_save_template.md): Saves a PDF once with its signature fields placed per signer role, to send again and again. $0.001 a call.
- [esign_send_template](https://conecto.chat/tools/esign/esign_send_template.md): Sends a saved template to new signers, one per role: one request, or up to 50 at once. $0.50 per request sent.
- [esign_list_templates](https://conecto.chat/tools/esign/esign_list_templates.md): The saved templates, with their roles and fields. Free up to 1,000,000 reads a month.
- [esign_delete_template](https://conecto.chat/tools/esign/esign_delete_template.md): Deletes a saved template; requests already sent from it stay as they are. Free.
- [esign_get](https://conecto.chat/tools/esign/esign_get.md): Where a signature request stands: each signer's status, and the signed PDF once everyone signed. Free up to 1,000,000 reads a month.
- [esign_list](https://conecto.chat/tools/esign/esign_list.md): Signature requests, newest first, optionally of one status. Free up to 1,000,000 reads a month.
- [esign_signing_link](https://conecto.chat/tools/esign/esign_signing_link.md): One signer's signing link, to hand over yourself. Free up to 1,000,000 reads a month.
- [esign_remind](https://conecto.chat/tools/esign/esign_remind.md): Emails everyone who still has to sign a reminder with their link, at most once a day. $0.02 a call.