---
title: "Decline to sign"
method: POST
path: "/api/signer/decline"
tags: ["signer"]
---

# Decline to sign

`POST /api/signer/decline`

Terminates the envelope (spec §5.5): appends `participant.declined` with the sanitized reason and the request's audit facts; the envelope status derives to `declined`. Allowed only when it is the signer's turn.

## Request body

- object
  - `reason` string

## Response `200`

The envelope was declined

- object
  - `status` 'draft' | 'detecting' | 'review' | 'in_progress' | 'completed' | 'declined' | 'voided' | 'expired', required

## Other responses

- `401` — Missing, invalid, expired, or reissued signing link
- `404` — The link's envelope or participant no longer exists
- `409` — Not the signer's turn, or the envelope is no longer active
- `422` — Malformed body or decline reason exceeds 500 characters (validation_error)

---

[API](https://skmtc.net/atlaswork/apis/atlas-api.md) · [All operations](https://skmtc.net/atlaswork/apis/atlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlaswork/atlas-api/versions/a8a1e7479c90/schema)