# Cancel Your Quorum Request

Take back an action you asked for, before anyone decides it.

## Overview

- Who asked only (`403` `QUORUM_NOT_REQUESTER`: `Only the requester cancels a request`), while it waits. `reason`: optional, up to 500 characters. No password.
- `200` with the request, `state` `cancelled`: nothing runs, and the held input is deleted. Decided already: `409` `QUORUM_NOT_AWAITING`.
- For the roles that decide requests (`owner`, `tenantadmin`, `non_signing_admin`, `security_admin`).

## Endpoint

### `POST /v1/quorum/requests/{id}/cancel`

Authentication: bearer token required.

Cancels your own request while it waits.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | The request's id |

**Request body**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `reason` | string | no | Up to 500 characters |

**Responses**

`403` Not yours

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "Only the requester cancels a request",
  "details": { "code": "QUORUM_NOT_REQUESTER" }
}
```

---

Web version: https://docs.aureahub.com/#quorum-request-cancel