# API reference

> Find API endpoints, request parameters, and response formats.

Use the Chunkify API to manage your video resources from your application. Each endpoint includes its request parameters and response format.

Resource management endpoints require a valid API token in the Authorization header. See [Authentication](/docs/api-reference/authentication). Asset preview URLs are public and do not require an API token.


## Base URL

All API requests should be sent to: `https://api.chunkify.dev/v1`

Combine each route with the base URL. For example, `GET /assets` becomes `GET https://api.chunkify.dev/v1/assets`.

Existing resource routes such as `/v1/api/jobs` remain supported for older SDKs, with the same requests and responses and no redirects. Asset routes use `/v1/assets/...`.

Ready Assets can [update to the latest revision of their Workflow](/docs/api-reference/assets/update-asset-workflow) to add missing outputs. Existing captions and static renditions are preserved. Inspect their execution with [Asset workflow actions](/docs/api-reference/assets/list-asset-workflow-actions).

Manage derived resources through [Asset outputs](/docs/video-streaming/outputs). The same collection supports creation, listing, retrieval, and deletion for each supported output type.

## Endpoints

Browse endpoints in the sidebar. See [Response formats](/docs/api-reference/response) for the shared response structure.

<cardgroup cols="3">
<card title="Assets" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-film"><rect width="18" height="18" x="3" y="3" rx="2"/><path d="M7 3v18"/><path d="M3 7.5h4"/><path d="M3 12h18"/><path d="M3 16.5h4"/><path d="M17 3v18"/><path d="M17 7.5h4"/><path d="M17 16.5h4"/></svg>" href="/docs/api-reference/assets/list-assets">
    Create video assets for streaming and manage their outputs.
</card>

<card title="Sources" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-video"><path d="m16 13 5.223 3.482a.5.5 0 0 0 .777-.416V7.87a.5.5 0 0 0-.752-.432L16 10.5"/><rect x="2" y="6" width="14" height="12" rx="2"/></svg>" href="/docs/api-reference/sources/get-all-sources">
    Add source videos from a URL and read their media properties.
</card>

<card title="Uploads" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-upload"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" x2="12" y1="3" y2="15"/></svg>" href="/docs/api-reference/uploads/get-all-uploads">
    Create upload sessions for direct transfers to storage.
</card>

<card title="Transcodings" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-clapperboard"><path d="M20.2 6 3 11l-.9-2.4c-.3-1.1.3-2.2 1.3-2.5l13.5-4c1.1-.3 2.2.3 2.5 1.3Z"/><path d="m6.2 5.3 3.1 3.9"/><path d="m12.4 3.4 3.1 4"/><path d="M3 11h18v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2Z"/></svg>" href="/docs/api-reference/transcodings/list-transcodings">
    Encode video and audio files and download the results.
</card>

<card title="Thumbnails" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-image"><rect width="18" height="18" x="3" y="3" rx="2" ry="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21"/></svg>" href="/docs/api-reference/thumbnails/create-thumbnails">
    Generate images or sprite sheets from a video.
</card>

<card title="Workflows" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-workflow"><rect width="8" height="8" x="3" y="3" rx="2"/><path d="M7 11v4a2 2 0 0 0 2 2h4"/><rect width="8" height="8" x="13" y="13" rx="2"/></svg>" href="/docs/api-reference/workflows/list-workflows">
    Automate Asset outputs and inspect their runs.
</card>

<card title="Storages" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-hard-drive"><line x1="22" x2="2" y1="12" y2="12"/><path d="M5.45 5.11 2 12v6a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2v-6l-3.45-6.89A2 2 0 0 0 16.76 4H7.24a2 2 0 0 0-1.79 1.11z"/><line x1="6" x2="6.01" y1="16" y2="16"/><line x1="10" x2="10.01" y1="16" y2="16"/></svg>" href="/docs/api-reference/storages/get-all-storages">
    Connect the buckets Chunkify reads from and writes to.
</card>

<card title="Webhooks" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-webhook"><path d="M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2"/><path d="m6 17 3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06"/><path d="m12 6 3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8"/></svg>" href="/docs/api-reference/webhooks/get-all-webhooks">
    Configure endpoints that receive event notifications.
</card>

<card title="Events" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-activity"><path d="M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2"/></svg>" href="/docs/api-reference/events/list-events">
    List lifecycle events and their webhook delivery attempts.
</card>

<card title="Notifications" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-bell"><path d="M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9"/><path d="M10.3 21a1.94 1.94 0 0 0 3.4 0"/></svg>" href="/docs/api-reference/notifications/get-all-notifications">
    Send or replay an event to a webhook endpoint.
</card>

<card title="Projects" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-folder"><path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/></svg>" href="/docs/api-reference/projects/get-all-projects">
    Create and configure the Projects in your team.
</card>

<card title="Tokens" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-key-round"><path d="M2.586 17.414A2 2 0 0 0 2 18.828V21a1 1 0 0 0 1 1h3a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h1a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h.172a2 2 0 0 0 1.414-.586l.814-.814a6.5 6.5 0 1 0-4-4z"/><circle cx="16.5" cy="7.5" r=".5" fill="currentColor"/></svg>" href="/docs/api-reference/tokens/list-all-api-tokens">
    Create and revoke API access tokens.
</card>

<card title="Analytics connections" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chart-line"><path d="M3 3v16a2 2 0 0 0 2 2h16"/><path d="m19 9-5 5-4-4-3 3"/></svg>" href="/docs/api-reference/projects/list-analytics-connections">
    Connect hosted or self-hosted analytics to a Project.
</card>

<card title="Metrics" icon="<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chart-column"><path d="M3 3v16a2 2 0 0 0 2 2h16"/><path d="M18 17V9"/><path d="M13 17V5"/><path d="M8 17v-3"/></svg>" href="/docs/api-reference/metrics/get-usage-metrics">
    Export Project usage and processing metrics as JSON or CSV.
</card>

</cardgroup>
