---
title: "Expand a carousel recipe into a slot document"
method: POST
path: "/carousels/recipes/{recipe_id}/expand"
tags: ["Project Management"]
---

# Expand a carousel recipe into a slot document

`POST /carousels/recipes/{recipe_id}/expand`

## Request

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

Turn a named recipe or a brief into compile-ready slides. Expand never publishes and never invents metrics.

## Path parameters

- `recipe_id` 'curiosity_gap_ugc_7' | 'result_first_demo_6' | 'myth_guillotine_8' | 'before_after_5' | 'from_brief', required

## Request body

- object
  - `locale` string
  - `platform` 'tiktok_photo' | 'instagram_4x5' | 'linkedin'
  - `name` string
  - `brief` string
  - `inputs` object
    - `audience` string
    - `product` string
    - `offer` string
    - `proof_mode` string
  - `visuals` object

## Response `200`

Successful response

- object
  - `recipe_id` 'curiosity_gap_ugc_7' | 'result_first_demo_6' | 'myth_guillotine_8' | 'before_after_5' | 'from_brief', required
  - `name` string, required
  - `locale` string, nullable
  - `platform` 'tiktok_photo' | 'instagram_4x5' | 'linkedin', required
  - `slides` object[], required
    - `role` 'hook' | 'body' | 'proof' | 'cta'
    - `lines` string[], required
    - `slots` object
    - `visual` object, required
      - `kind` 'creative_source' | 'media_asset' | 'generate' | 'solid' | 'gradient' | 'html' | 'template', required
      - `media_asset_id` string, uuid
      - `prompt` string
      - `model_id` string
      - `color` string
      - `colors` string[]
      - `html` string
      - `template_id` string
      - `source_media_asset_id` string, uuid
      - `creative_artifact_id` string, uuid
      - `crop` object
        - `left` number, required
        - `top` number, required
        - `width` number, required
        - `height` number, required
    - `layout` 'chip_stack_ui' | 'chip_stack_face_safe' | 'chip_stack_top' | 'title_body_card'
    - `layout_overrides` object
      - `top_px` integer

## 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)