Deleting a channel

Overview

There are two ways to delete a channel:

• In OpCon – see Editing and deleting channels.

• Via an API call, as described below.

In either case, the actual channel deletion is the final step in a series of actions that must be performed in the correct sequence.

Prerequisites – actions to be taken before deleting a channel

The following steps must be performed in this order before deleting a channel to minimise disruptions and maintain system integrity:

1. Stop EPG ingestion for the channel so that only a few days worth of EPG is available.

2. Wait until all ongoing workflows related to the channel have completed (for example, processing of LTCU and NPVR jobs).
   You can see the workflow jobs for the channel in OpCon – see Workflow management.

3. Disable LTCU, STCU, and NPVR for the channel in OpCon – see Enabling and disabling Replay TV for channels.

Deleting the channel through an API call

Request

To delete an editorial channel, send a DELETE request to:

https://<host>:<port>/metadata/content/v1/editorialChannels/{editorialChannelId}?purgeService=true

This deletes:

• The editorial channel

• All of its technical channels

• All the channel’s events

• All related workflow jobs

• All related encoder assets

• All related (catch-up) technical contents

Headers

• Content-Type: application/json

Mandatory arguments

None

Other arguments

None

Response

A successful request returns an HTTP 200 status. The response includes the URI of the deleted editorial channel.

If the delete action had no effect, the request returns an HTTP 204 status.

A bad request returns an HTTP 400 status.

See also

For full details of this API, see Content and Product Manager (CPM) API documentation: content v1 .