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.

The stable identifier for the VOD asset. Use this value when checking processing status, updating metadata, or generating playback information.

A timestamp (milliseconds) marking when the asset record was created. This can be used for sorting or catalog operations.

Metadata and descriptive fields

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

The user‑visible name of the asset, shown in dashboards and typically displayed in playback interfaces.

Optional descriptive text for cataloging or UI display.

A list intended for custom structured values you supply. Common uses include categorization, editorial notes, or workflow flags.

Initially set to 0. Once processing finishes, this updates to the actual media duration in seconds.

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.

An array of policy rules such as public, which determines who can retrieve playback URLs. Policies map directly to player authorization requirements.

Indicates whether the service will generate an MP4 rendition for direct file delivery.

Specifies whether the original uploaded media file is retained.

A flag that identifies whether the asset was created using a test or sample flow.

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?

Last updated Dec 22, 2025

Built with Documentation.AI