> ## Documentation Index
> Fetch the complete documentation index at: https://docs.totalis.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel Quote Request

> Cancel an active quote request.

Cancel an active quote request. All pending market maker quotes are invalidated and the request is removed from the live stream. Returns `204 No Content` on success.

You can only cancel a quote request while its status is `active`.

## Authentication

API key required. Pass your API key in the `X-API-Key` header. The key needs the `trading:write` scope.

```
X-API-Key: <your-api-key>
```

A Privy JWT (`Authorization: Bearer <jwt>`) is also accepted — see [Authentication](/guides/authentication).

## Path parameters

<ParamField path="id" type="string" required>
  The quote request ID (UUID).
</ParamField>

## Response

Returns `204 No Content` with no response body.

## Errors

| Status | Code           | Description                                                |
| ------ | -------------- | ---------------------------------------------------------- |
| 401    | `UNAUTHORIZED` | Missing or invalid API key.                                |
| 403    | `FORBIDDEN`    | You do not own this quote request.                         |
| 404    | `NOT_FOUND`    | Quote request not found.                                   |
| 409    | `CONFLICT`     | Quote request is already committed, cancelled, or expired. |

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.totalis.trade/v1/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40/cancel \
    -H "X-API-Key: $TOTALIS_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```bash 204 theme={null}
  # No response body
  ```
</ResponseExample>