v50

latestOpenAPI 3.0.3raw.githubusercontent.com2025-01-2810050281.4 KB
Media Assets

Add ISMC Manifest

Adds the location of an ismc_manifest file for a remote asset. Note: you can use /videos/ref:reference_id instead of /videos/video_id

post/v1/accounts/{{account_id}}/videos/{{video_id}}/assets/ismc_manifest

Path parameters

account_idstring required

Video Cloud account ID.

video_idstring required

Video ID (specified as {video_id}}).

Headers

Content-Typestring required

Content-Type: application/json

Authorizationstring required

Authorization: Bearer {access_token} - see Getting Access Tokens

Request body

audio_onlyboolean

not applicable to ism_manifests

cdn_origin_idstring

an internally used id (not applicable to remote assets)

completeboolean

whether processing is complete for the asset (will be true for remote assets if a remote_url is supplied)

controller_typestring

the controller type for ingested renditions (not applicable to remote renditions or other types of assets)

current_filenamestring

the filename for an ingested asset in the Video Cloud system (not applicable to remote assets)

idstring

the asset id

namestring

asset name

progressive_downloadboolean

whether ingested rendition is available by progressive download (not applicable to other asset types or remote renditions)

reference_idstring

the asset reference id (must be unique within the account); this is not the same as the video reference id

remote_stream_namestring

name for remote streams (not applicable to asset types other than rendition)

remote_urlstring

the url for a remote asset (not applicable to ingested assets); remote_url is required when adding an asset (POST)

sizeinteger

the size of the asset in bytes (integer)

typestring

the type of the asset

updated_atstring

when the video was last modified

uploaded_atstring

when the asset was added to the video in Video Cloud

video_durationinteger

video duration in seconds (present if you included it when you created the asset)

Example request

{
  "account_id": "57838016001",
  "audio_only": false,
  "cdn_origin_id": "8801",
  "complete": true,
  "controller_type": "DEFAULT",
  "current_filename": "57838016001_5819043232001_5819044609001.m3u8",
  "id": "5819043232001",
  "key_systems": [],
  "name": "greatblueheron.mp4",
  "progressive_download": false,
  "reference_id": "",
  "remote_stream_name": "",
  "remote_url": "",
  "size": 0,
  "type": "HLS_MANIFEST",
  "updated_at": "2018-08-07T14:06:52.489Z",
  "uploaded_at": "2018-08-07T14:05:57.105Z",
  "video_duration": 0
}

Response

Manifest asset created

audio_onlyboolean

not applicable to ism_manifests

cdn_origin_idstring

an internally used id (not applicable to remote assets)

completeboolean

whether processing is complete for the asset (will be true for remote assets if a remote_url is supplied)

controller_typestring

the controller type for ingested renditions (not applicable to remote renditions or other types of assets)

current_filenamestring

the filename for an ingested asset in the Video Cloud system (not applicable to remote assets)

idstring

the asset id

namestring

asset name

progressive_downloadboolean

whether ingested rendition is available by progressive download (not applicable to other asset types or remote renditions)

reference_idstring

the asset reference id (must be unique within the account); this is not the same as the video reference id

remote_stream_namestring

name for remote streams (not applicable to asset types other than rendition)

remote_urlstring

the url for a remote asset (not applicable to ingested assets); remote_url is required when adding an asset (POST)

sizeinteger

the size of the asset in bytes (integer)

typestring

the type of the asset

updated_atstring

when the video was last modified

uploaded_atstring

when the asset was added to the video in Video Cloud

video_durationinteger

video duration in seconds (present if you included it when you created the asset)

Example response

{
  "account_id": "57838016001",
  "audio_only": false,
  "cdn_origin_id": "8801",
  "complete": true,
  "controller_type": "DEFAULT",
  "current_filename": "57838016001_5819043232001_5819044609001.m3u8",
  "id": "5819043232001",
  "key_systems": [],
  "name": "greatblueheron.mp4",
  "progressive_download": false,
  "reference_id": "",
  "remote_stream_name": "",
  "remote_url": "",
  "size": 0,
  "type": "HLS_MANIFEST",
  "updated_at": "2018-08-07T14:06:52.489Z",
  "uploaded_at": "2018-08-07T14:05:57.105Z",
  "video_duration": 0
}