---
title: "Update a Story Kit using optimistic concurrency"
method: PATCH
path: "/story-kits/{storyKitId}"
tags: ["AI Generation"]
---

# Update a Story Kit using optimistic concurrency

`PATCH /story-kits/{storyKitId}`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/story-kits/{storyKitId}`
- Auth: API key in header `Authorization`

Update a Story Kit using optimistic concurrency.

## Path parameters

- `storyKitId` string, uuid, required

## Request body

- object
  - `name` string, required
  - `description` string, nullable
  - `visual_style` string, required
  - `style_reference_asset_ids` string[]
  - `facts` string[]
  - `locations` object[]
    - `id` string, required
    - `name` string, required
    - `canonical_description` string, required
    - `reference_asset_ids` string[]
    - `facts` string[]
  - `character_ids` string[]
  - `narrator_character_id` string, uuid, nullable
  - `expected_revision` integer, required

## Response `200`

Successful response

- object
  - `id` string, uuid, required
  - `revision` integer, required
  - `name` string, required
  - `description` string, nullable, required
  - `visual_style` string, required
  - `style_reference_asset_ids` string[], required
  - `facts` string[], required
  - `locations` object[], required
    - `id` string, required
    - `name` string, required
    - `canonical_description` string, required
    - `reference_asset_ids` string[], required
    - `facts` string[], required
  - `character_ids` string[], required
  - `narrator_character_id` string, uuid, nullable, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `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)