Organizing: collections & webhooks

Group related assets into collections, and get HTTP notifications when asset and job state changes.

Collections

A collection is a named, flat group of assets — useful for shows, campaigns, or any grouping that doesn't belong on the asset record itself.

curl -X POST https://<your-instance>/api/v1/collections \
  -H "Content-Type: application/json" \
  -d '{"name": "Q3 keynotes"}'

Add and remove assets with PUT /api/v1/collections/{id}/assets/{assetId} / DELETE /api/v1/collections/{id}/assets/{assetId}. Full shape in the Collections reference.

Webhooks

Register an HTTP endpoint to be notified as assets and jobs change state, instead of polling:

curl -X POST https://<your-instance>/api/v1/webhooks \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-app.example.com/hooks/videocore", "events": ["asset.ready", "transcode.complete", "package.complete"]}'

Available events: asset.ready, asset.failed, transcode.complete, transcode.failed, package.complete, package.failed. Pass a secret to have deliveries signed. Full shape in the Webhooks reference.