Video on Demand (VOD)Content management
Video on Demand (VOD)

Managing Video Content

Understand the fields returned after creating VOD content, and how they help you track processing status and enable playback flows.

{
  "code": 200,
  "data": {
    "contentId": "fa6d3dc8-c78c-4c67-98ef",
    "created_at": 1673353801033,
    "description": "",
    "duration": 0,
    "metadata": [],
    "mp4_support": true,
    "playbackPolicy": [
      "public"
    ],
    "save_original_copy": false,
    "status": "Pending",
    "statusId": 1,
    "test_video": true,
    "title": "Demo Video"
  },
  "message": "Data success",
  "status": "Success"
}
{
  "status": "Pending",
  "statusId": 1
}

Overview

After you upload or create a video through the API, the service responds with a structured content object. This object includes identifiers, lifecycle status, metadata fields, and playback‑related properties you will reference in later requests. The screenshot below shows the Videograph dashboard where you can manage created assets including clips, thumbnails, subtitles, and metadata.

This page explains the key fields from the creation response and how they fit into the broader workflow. For guidance on uploading, see Uploading Videos (Dashboard & API). For playback usage, see Playing Videos (Web & App Integration).

Example creation response

The following response reflects what you receive immediately after a successful content creation request. Values may vary depending on your workflow.

Core identifiers

These fields uniquely identify the asset and anchor all future operations.

Metadata and descriptive fields

These fields help you label and organize the asset. They generally reflect information supplied at creation time.

Processing and readiness status

The service begins preparing your video as soon as the content record is created. These fields tell you whether the asset is ready to play.

After creation, the asset often begins in Pending or Preparing. Most workflows check status before generating or using playback URLs.

How to use these fields

  • Poll the content endpoint (see the API reference) using the contentId.

  • When status transitions to a ready value, duration and playback assets become available.

  • You can then allow clients, apps, or services to request playback URLs.

Playback‑related properties

These fields control or describe how playback can occur later.

Using the content object in your workflow

The creation response enables the two most common next steps:

Check status

Query the asset using the contentId until status indicates readiness. Refer to Monitoring Processing & Content Status for related concepts.

Play the video

Once the asset is ready, request playback URLs according to your playbackPolicy. Integration details are available in Playing Videos (Web & App Integration).

The creation response is your source of truth for tracking the asset from upload to playback. Keep the contentId available in your application or workflow to streamline later calls.

Was this page helpful?
Built with Documentation.AI

Last updated 3 weeks ago