---
title: "POST /v1/assets/{asset_id}/preview-token — Issue a time-limited preview token for an asset's preview rendition."
method: POST
path: "/v1/assets/{asset_id}/preview-token"
tags: ["Tokens"]
---

# POST /v1/assets/{asset_id}/preview-token — Issue a time-limited preview token for an asset's preview rendition.

`POST /v1/assets/{asset_id}/preview-token`

## Request

- Base URL: `https://api.stockfilm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stockfilm.com/v1/assets/{asset_id}/preview-token`
- Auth: API key in header `Authorization`

The asset must be active, machine-ready, and have at least one available
preview rendition. Returns 404 for missing/cross-tenant assets and 409
when the asset is not eligible or lacks a preview rendition.

## Path parameters

- `asset_id` string, uuid, required

## Request body

- CreatePreviewTokenRequest: Request body for POST /v1/assets/{asset_id}/preview-token.
  - `ttl_minutes` integer, nullable: Optional TTL in minutes (default 15).

## Response `201`

Preview token issued

- CreatePreviewTokenResponse: Response for POST /v1/assets/{asset_id}/preview-token.
  - `asset_id` string, uuid, required
  - `asset_rendition_id` string, uuid, required
  - `expires_at` string, required
  - `preview_token_id` string, uuid, required
  - `token_id` string, required

## Other responses

- `400`: Invalid TTL
- `404`: Asset not found
- `409`: Asset not eligible or no preview rendition

---

[API](https://skmtc.dev/stockfilm/apis/stockfilm-api.md) · [All operations](https://skmtc.dev/stockfilm/apis/stockfilm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stockfilm/apis/stockfilm-api/revisions/ef244025c706?raw)