---
title: "Update Carousel"
method: PATCH
path: "/workspaces/{workspace_id}/carousels/{carousel_id}"
tags: ["carousels"]
---

# Update Carousel

`PATCH /workspaces/{workspace_id}/carousels/{carousel_id}`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/workspaces/{workspace_id}/carousels/{carousel_id}`
- Auth: HTTP bearer

## Path parameters

- `workspace_id` string, required
- `carousel_id` string, required

## Request body

- CarouselUpdate
  - `slides` SlideIn[], nullable
    - `num` integer, required
    - `hook` string, required
    - `bullets` string[]
    - `resource_url` string, nullable
    - `thumbnail_url` string, nullable
    - `generated_image_url` string, nullable
    - `image_versions` string[]
    - `image_version_idx` integer
    - `alt_text` string, nullable
    - `user_tags` UserTag[]
      - `username` string, required
      - `x` number, required
      - `y` number, required
  - `theme_label` string, nullable
  - `theme_prompt` string, nullable
  - `color_palette` string[], nullable
  - `fonts` string[], nullable
  - `status` 'draft' | 'generating' | 'ready'

## Response `200`

Successful Response

- CarouselOut
  - `id` string, required
  - `workspace_id` string, required
  - `created_by` string, required
  - `topic` string, required
  - `slide_count` integer, required
  - `content_type` 'general' | 'curation', required
  - `slides` SlideOut[], required
    - `num` integer, required
    - `hook` string, required
    - `bullets` string[], required
    - `resource_url` string, nullable, required
    - `thumbnail_url` string, nullable, required
    - `generated_image_url` string, nullable, required
    - `image_versions` string[]
    - `image_version_idx` integer
    - `alt_text` string, nullable
    - `user_tags` UserTag[]
      - `username` string, required
      - `x` number, required
      - `y` number, required
  - `theme_label` string, nullable, required
  - `theme_prompt` string, nullable, required
  - `color_palette` string[]
  - `fonts` string[]
  - `status` 'draft' | 'generating' | 'ready', required
  - `s3_prefix` string, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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