Skip to Content
Update an asset
patch

Updates the details of an already-created Asset with the provided Asset ID. This currently supports only the passthrough field.

Request body params
passthrough
string

You can set this field to anything you want. It will be included in the asset details and related webhooks. If you're looking for more structured metadata, such as title or external_id , you can use the meta object instead. Max: 255 characters. In order to clear this value, the field should be included with an empty string value.

meta.title
string

The video title. Max 512 code points.

meta.creator_id
string

This is an identifier you provide to keep track of the creator of the video. Max 128 code points.

meta.external_id
string

This is an identifier you provide to link the video to your own data. Max 128 code points.

Request path & query params
ASSET_ID
string

The asset ID.

patch
200
/video/v1/assets/{ASSET_ID}
Request
(application/json)
{
  "passthrough": "Example"
}
Response
(application/json)
{
  "data": {
    "tracks": [
      {
        "type": "video",
        "max_width": 1920,
        "max_height": 1080,
        "max_frame_rate": 29.97,
        "id": "RiyQPM31a1SPtfI802bEP2zD02F5FQVNL801FRHeE5t01G4",
        "duration": 23.8238
      },
      {
        "type": "audio",
        "max_channels": 2,
        "id": "LvINTciHVoC017knMCH01y9pSi5OrDLCRaBPNDAoNJcmg",
        "duration": 23.823792
      }
    ],
    "status": "ready",
    "playback_ids": [
      {
        "policy": "public",
        "id": "vAFLI2eKFFicXX00iHBS2vqt5JjJGg5HV6fQ4Xijgt1I"
      }
    ],
    "max_stored_resolution": "HD",
    "resolution_tier": "1080p",
    "max_stored_frame_rate": 29.97,
    "master_access": "none",
    "id": "lJ4bGGsp7ZlPf02nMg015W02iHQLN9XnuuLRBsPS00xqd68",
    "encoding_tier": "baseline",
    "video_quality": "basic",
    "duration": 23.857167,
    "created_at": "1609868768",
    "updated_at": "1609869000",
    "aspect_ratio": "16:9",
    "passthrough": "Example"
  }
}