asset.playback_ready
Payload for asset.playback_ready, recorded when a video asset can start HLS playback.
asset.playback_ready is recorded when the video asset's initial HLS stream becomes playable. The payload has playback_ready: true, even if its status is still preparing.
The poster and timeline previews may not be available yet. Handle asset.ready to receive their URLs when playback, the poster, and timeline previews are all ready.
Whether the Asset can accept new static rendition requests. Creation can still fail if the original video is no longer accessible.
When the Asset was created.
Unique Asset ID.
Maximum streaming resolution selected at creation. Does not limit static renditions.
1080p2160pString metadata attached to the Asset.
map[key:value key2:value2]Minimum streaming resolution selected at creation. auto means no minimum; smaller sources are not upscaled.
auto240p360p540p720p1080p1440p2160pWhether HLS playback is available, including while the Asset is preparing.
Allow public preview access without an API token. Does not control CDN or static download access. Disabling it does not revoke signed URLs already issued.
Original audio bitrate in bits per second, or zero when unavailable.
Original audio codec, or an empty string when there is no audio.
Original audio sample rate in Hz, or zero when unavailable.
Original duration in seconds.
Original video height in pixels.
Original file size in bytes.
Original video bitrate in bits per second, or zero when unknown.
Original video codec.
Original video frame rate in frames per second.
Original video width in pixels.
Status specifies the Asset preparation state. ready means the video is prepared for playback, with its poster and timeline previews available. Static renditions and captions have independent statuses.
preparingreadyfailedexpiredID of the output Storage.
Asset title.
When the Asset was last updated.
Selected Workflow ID, or null.
Pinned Workflow revision, or null.
Unsigned CDN URL of the HLS master playlist. Available when playback_ready is true and Storage has a CDN URL.
CreatedByTokenId specifies the Project token used to create the resource. It remains set after the token is revoked. Omitted for dashboard requests, MCP OAuth connections, Workflow actions, and unknown creators.
tok_2G6MJiNz71bHQGNzGwKx5cJwPFSCreatedByUserId specifies the team member who created the resource. Omitted for Workflow actions, unknown creators, and deleted accounts.
u_2G6MJiNz71bHQGNzGwKx5cJwPFSCreatedVia specifies how the resource was created: api for API requests, dashboard for the Chunkify dashboard, mcp for MCP clients, and workflow for Workflow actions. Omitted when the creator is unknown.
apidashboardmcpworkflowapiMachine-readable processing error code.
Description of the processing failure.
Processing stage that failed.
ingestanalysisencodingpackaginguploadvalidationcleanupWhen managed outputs expire, 24 hours after readiness. Omitted for customer-connected Storage.
Path of the HLS master playlist in Storage. Available when playback_ready is true.
When HLS playback first became available.
Poster image, available once generated.
Image height in pixels.
x >= 0Image path in Storage.
Image width in pixels.
x >= 0Unsigned image CDN URL. Available once the poster exists and Storage has a CDN URL.
Public poster preview URL. Available when the Asset is ready and preview_enabled is true.
Image size in bytes.
x >= 0Position of the selected frame in seconds.
x >= 0Signed image URL, valid for up to ten minutes. Available once the poster exists, regardless of preview_enabled.
Public HLS preview URL. Available when playback_ready and preview_enabled are true. No API token is required.
When all required Asset outputs finished processing.
Size specifies the total bytes of available streaming, playback preview, poster, and timeline files. Excludes static renditions. Omitted until the Asset is ready.
x >= 0Original Source ID. Omitted after Source deletion.
Timeline thumbnails. The WebVTT file maps video timestamps to image URLs and crop coordinates.
Thumbnail image layout.
WebVTT file path in Storage.
Unsigned WebVTT CDN URL. Available when the Asset is ready and Storage has a CDN URL.
Number of thumbnails.
x >= 0Target thumbnail sampling interval in seconds. The WebVTT file provides actual cue timestamps.
x >= 0Public WebVTT preview URL with signed image references. Available when the Asset is ready and preview_enabled is true.
Combined WebVTT and sprite image size in bytes.
x >= 0Number of sprite images containing the thumbnails.
x >= 0Thumbnail height in pixels.
x >= 0Thumbnail width in pixels.
x >= 0