---
title: "Send or void an envelope"
method: POST
path: "/api/v1/envelopes/{id}"
tags: ["Envelopes"]
---

# Send or void an envelope

`POST /api/v1/envelopes/{id}`

## Request

- Base URL: `https://swiftsign.ca`
- URL: `https://swiftsign.ca/api/v1/envelopes/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- EnvelopeActionBody
  - `action` 'send' | 'void', required

## Response `200`

Action applied.

- EnvelopeActionResult
  - `status` 'sent' | 'voided', required
  - `envelopeId` string, required

## Other responses

- `400`: Invalid action.
- `401`: Missing or invalid API key.
- `404`: Envelope not found.
- `409`: Envelope is not in a valid state for this action.

---

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