Docs / Guides / Delivery & playback

Delivery & playback

Get a playable URL for an asset — proxied HLS/DASH manifests or a presigned source download.

Once an asset is packaged (or if you just need the source back), one endpoint resolves the right URL for playback.

Get playback URLs

Request

curl https://<your-instance>/api/v1/assets/<id>/delivery

Depending on the asset's state, this returns HLS/DASH manifest URLs (proxy-streamed through the API), a presigned source download, or both. See ADR-003 in the repository for the full contract this endpoint follows.

Streaming manifests and segments

Manifest URLs returned above point back at:

Path

GET /api/v1/assets/{id}/stream/*

This proxy-streams the packaged HLS/DASH manifest and its media segments, so player requests never need direct access to the underlying object storage bucket or its credentials.

The API reference is generated from openapi.json, committed in the open-videocore repository. Interactive, always-current reference docs are also served at /api-docs on any running instance.