---
title: "Void a live agreement"
method: POST
path: "/agreements/{id}/void"
tags: ["Agreements"]
---

# Void a live agreement

`POST /agreements/{id}/void`

## Request

- Base URL: `https://dataroom.corgi.com/api/v1`
- URL: `https://dataroom.corgi.com/api/v1/agreements/{id}/void`
- Auth: HTTP bearer

Voids a Sent/Viewed/Partially-signed agreement — the record is kept for audit but can no longer be signed. Fails `409 invalid_state` on a draft or completed agreement. Scope: `envelopes:write`.

## Path parameters

- `id` string, required

## Request body

- object
  - `reason` string

## Response `200`

Voided

## Other responses

- `404`: Not found
- `409`: Not in a voidable state

---

[API](https://skmtc.dev/corgi/apis/dataroom-api.md) - [All operations](https://skmtc.dev/corgi/apis/dataroom-api/llms.txt) - [OpenAPI document](https://skmtc.dev/corgi/apis/dataroom-api/revisions/73f75ef04a00?raw)