---
title: "Create a batch operation on EPG information."
method: POST
path: "/api/v2/metapub/program-information/batch"
tags: ["MetaPub"]
deprecated: true
---

# Create a batch operation on EPG information.

`POST /api/v2/metapub/program-information/batch`

> **Deprecated.**

Create a batch to process the metadata of one or more electronic program guide (EPG) programs using metadata that has been uploaded to the customer's CD Drive. If multiple EPG programs are present in the metadata, they will all be updated, however updates across programs are not atomic. Note that an EPG program maps to the ContentDepot concept of an episode which is also known as a "program instance".

A batch operation must be explicitly created rather than the server attempting to detect new metadata in order to allow for all the content to be uploaded including any supporting content like images. A batch operation is accepted and queued for asynchronous processing at a later time. A client can poll the batch periodically to determine when it completes and the resulting state.

## Request body

- object — The batch operation definition.
  - `uri` string, uri, required — The URI to the metadata file. Currently only the ```cddrive``` scheme is supported.
  - `format` 'radiodns', required — The format of the metadata file defining the create or update actions to be performed on one or more EPG programs. For more information on how RadioDNS EPG maps to ContentDepot <a href="/api/epg-cd-mapping.html">click here </a>
  - `name` string — An optional human readable name for the batch.
  - `program` object — The program information to associate the ingested metadata with. This is only required if the metadata format doesn't provide the program title and air date information directly.
    - `title` string, required
    - `airDate` string, date-time, required — the airdate in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss'Z')

## Response `202`

The accepted batch information that is queued for processing.

- ProgramInformationBatch — An electronic program guide (EPG) batch operation to create or update metadata on one or more guide programs.
  - `id` integer, required — The ID of the batch.
  - `name` string — The optional name of the batch for human reference.
  - `message` string — The human readable success or failure message.
  - `status` 'queued' | 'processing' | 'failed' | 'successful', required — The current processing status.
  - `uri` string, uri — The URI to the metadata file defining the batch creates/updates.
  - `format` 'radiodns', required — The format of the metadata file defining the create or update actions to be performed on one or more EPG programs.
  - `program` object — The program information to associate the ingested metadata with. This is only required if the metadata format doesn't provide the program title and air date information directly. If this is specified, it will overrite the value specfified in the metadata file. If this is specified, the metadata file should only contain one program.
    - `title` string, required — The title of the program.
    - `airDate` string, date-time, required — The airDate for the program in ISO 8601 format.
  - `createdDate` string, date-time, required — The date and time the batch was created in ISO 8601 format.
  - `finishedDate` string, date-time — The date and time the batch finished (either successful or failed) in ISO 8601 format.

---

[API](https://skmtc.net/prss/apis/contentdepot.md) · [All operations](https://skmtc.net/prss/apis/contentdepot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prss/contentdepot/versions/838e7ae589d8/schema)