Skip to content
handupbeta
Download

delete_requests

View as Markdown
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.

Media typeapplication/json

Body of POST /v1/requests/delete.

object
ids
required

Request ids to delete (at most 1000).

Array<string>
Media typeapplication/json

Result of POST /v1/requests/delete.

object
deleted
required

Ids removed, in request order.

Array<string>
missing
required

Ids that matched no request.

Array<string>

Empty batch, or more than 1000 ids

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