Assets

Update an asset

Updates the details of an existing Asset with the provided Asset ID. This API currently only supports the passthrough and meta fields.

patch/video/v1/assets/{ASSET_ID}

Path parameters

ASSET_IDstring required

The asset ID.

Request body

passthroughstring

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.

Response

Changes

Changed in 10 of the 28 revisions of this API.11418

Jan 7, 202683dc80cce4d61See the full diff
- ○
  added the optional property data/tracks/items/auto_language_confidence to the response with the 200 status
  response-optional-property-added
Aug 5, 2025ba7ebfd893a11See the full diff
- ○
  the endpoint scheme security authorizationToken was added to the API
  api-security-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 2, 2025d4d7fca3b7382See the full diff
- ○
  the endpoint scheme security accessToken was added to the API
  api-security-added
- ○
  added the required property data/progress to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 15, 20257f3ef26966f01See the full diff
- ●
  added the new audio-only enum value to the data/static_renditions/files/items/resolution_tier response property for the response status 200
  response-property-enum-value-added
Mar 6, 20255f3a1cefec232See the full diff
- ○
  added the new optional request property meta
  new-optional-request-property
- ○
  added the optional property data/meta to the response with the 200 status
  response-optional-property-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 25, 20252eec862e7514197See the full diff
- ▲
  the response property data/mp4_support became optional for the status 200
  response-property-became-optional
- ●
  added the new 1080p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new 1440p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new 2160p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new 270p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new 360p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new 480p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new 540p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new 720p.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ●
  added the new highest.mp4 enum value to the data/static_renditions/files/items/name response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property data/static_renditions/files/items/id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/static_renditions/files/items/passthrough to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/static_renditions/files/items/resolution to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/static_renditions/files/items/resolution_tier to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/static_renditions/files/items/status to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/static_renditions/files/items/type to the response with the 200 status
  response-optional-property-added
- ○
  response property data/mp4_support deprecated
  response-property-deprecated
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 15, 20245bc9dec57cc412See the full diff
- ●
  added the new premium enum value to the data/encoding_tier response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property data/video_quality to the response with the 200 status
  response-optional-property-added
- ○
  response property data/encoding_tier deprecated
  response-property-deprecated
This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 11, 20246aab47a3857711See the full diff
- ●
  added the new drm enum value to the data/playback_ids/items/policy response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property data/playback_ids/items/drm_configuration_id to the response with the 200 status
  response-optional-property-added
Jun 6, 2024dcdbbcabe09e11See the full diff
- ●
  removed the optional property data/playback_ids/items/drm_configuration_id from the response with the 200 status
  response-optional-property-removed
- ○
  removed the drm enum value from the data/playback_ids/items/policy response property for the response status 200
  response-property-enum-value-removed
Jun 6, 2024cc252d3a50f111See the full diff
- ●
  added the new drm enum value to the data/playback_ids/items/policy response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property data/playback_ids/items/drm_configuration_id to the response with the 200 status
  response-optional-property-added

Full history