> For AI agents: the documentation index is at https://docs.gethandup.dev/llms.txt. Append .md to any page URL (without the trailing slash) for Markdown, for example https://docs.gethandup.dev/cli.md.

# delete_requests

`POST /v1/requests/delete`

Permanently delete requests, pending or resolved, with their audit rows and previews no other request uses. A pending request is cancelled first, so an agent waiting on it sees `cancelled`, never an approval, and `request.cancelled` then `request.deleted` are emitted; a resolved request only emits `request.deleted`. Unknown ids are listed in `missing`. Needs decide scope for paired devices.

## Request Body required

Media type: `application/json`

`object`

Body of `POST /v1/requests/delete`.

- **ids** (required): `Array<string>`

  Request ids to delete (at most 1000).

## Responses

### 200

Media type: `application/json`

`object`

Result of `POST /v1/requests/delete`.

- **deleted** (required): `Array<string>`

  Ids removed, in request order.

- **missing** (required): `Array<string>`

  Ids that matched no request.

### 400

Empty batch, or more than 1000 ids

### 403

Remote device without decide scope, or disabled, downgraded or revoked by the time the delete commits
