---
title: "Preview compiled carousel slides as stills"
method: POST
path: "/carousels/{projectId}/preview"
tags: ["Project Management"]
---

# Preview compiled carousel slides as stills

`POST /carousels/{projectId}/preview`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/carousels/{projectId}/preview`
- Auth: API key in header `Authorization`

Render JPEG stills for selected slides at the exact platform frame (TikTok photo is 1080x1920). Returns signed image URLs.

## Path parameters

- `projectId` string, uuid, required

## Request body

- object
  - `idempotencyKey` string, nullable
  - `chrome` 'tiktok' | 'instagram' | 'none'
  - `slide_indexes` integer[]

## Response `200`

Successful response

- object
  - `project_id` string, uuid, required
  - `revision` integer, required
  - `platform` 'tiktok_photo' | 'instagram_4x5' | 'linkedin', nullable, required
  - `frame` object, required
    - `width` integer, required
    - `height` integer, required
    - `aspect_ratio` string, required
  - `slides` object[], required
    - `index` integer, required
    - `preview_url` string, required
    - `width` integer, required
    - `height` integer, required
    - `expires_at` string, required
    - `print` 'slots' | 'ingested'
  - `warnings` object[], required
    - `code` string, required
    - `message` string, required
    - `field` string
    - `repair` string
  - `next_actions` object[], required
    - `method` 'GET' | 'POST' | 'PATCH' | 'DELETE', required
    - `path` string, required
    - `reason` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

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