Delete an event recording request

Request

To delete an event recording or request, send a DELETE request to:

https://<host>:<port>/cdvr/v1/recordings/{id}

If the recording already exists, it is deleted. If the content has not yet been recorded, the request is cancelled.

Headers

• Content-Type: application/json
• Authorisation

Mandatory arguments

• id – the ID of the event recording/request to be deleted

Example

A DELETE request like this cancels the recording request for the event with the ID eastenders_10297, or, if the event has already been recorded, deletes the recording:

http://<host>:<port>/cdvr/v1/recordings/eastenders_10297

Response

A successful request returns an HTTP 204 status.

An unauthorised request returns an HTTP 401 status.

See also

For full details of this API, see the User Recordings API documentation.