---
title: "Void an e-signature request"
method: POST
path: "/signature-requests/{id}/void"
tags: ["SignatureRequests"]
---

# Void an e-signature request

`POST /signature-requests/{id}/void`

## Request

- Base URL: `https://app.buildworkpro.com/api/v1`
- URL: `https://app.buildworkpro.com/api/v1/signature-requests/{id}/void`
- Auth: HTTP bearer

Cancels an active request and kills its signing link. The stored row is the source of truth; cancelling the remote document is best-effort.

## Path parameters

- `id` integer, required

## Headers

- `Idempotency-Key` string, uuid

## Response `200`

Voided

- object
  - `data` SignatureRequest, required
    - `id` integer, required
    - `entityType` 'bid' | 'change_order', required
    - `entityId` integer, required
    - `status` string, required
    - `signerName` string, nullable, required
    - `signerEmail` string, nullable, required
    - `sentAt` union, required
      - string, date-time
      - string
    - `signedAt` union, required
      - string, date-time
      - string
    - `signedDocumentId` integer, nullable, required
    - `signingUrl` string, nullable: Present only for callers holding signatures:send, and only while the request is pending or sent.

## Other responses

- `403`: Error
- `404`: Error
- `409`: Error

---

[API](https://skmtc.dev/buildworkpro/apis/buildworkpro-api.md) · [All operations](https://skmtc.dev/buildworkpro/apis/buildworkpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buildworkpro/apis/buildworkpro-api/revisions/441cf40012f7?raw)