---
title: "One streamed turn of the creative sandbox chat"
method: POST
path: "/api/v1/creative-sandbox/chat"
tags: ["creativeSandbox"]
---

# One streamed turn of the creative sandbox chat

`POST /api/v1/creative-sandbox/chat`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/creative-sandbox/chat`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/brandbooster/apis/brandbooster-api/docs/api/v1/creative-sandbox/chat/post.ts> (a function with typed inputs; its response is checked against the schema)

Server-Sent Events: session, message, delta, tool_start, tool_result, done, error. Leave session_id out
to start a thread. Generation tools hand back task ids; poll their own status routes.

## Request body

- SandboxChatDTO: One turn of the creative sandbox chat. Leave session_id out to start a new thread.
  - `session_id` string, uuid, nullable
  - `message` string
  - `attachments` SandboxAttachmentDTO[]
    - `kind` 'image' | 'video' | 'audio' | 'storyboard' | 'cs_storyboard' | 'library_video' | 'file'
    - `name` string, required
    - `url` string, nullable
    - `text` string, nullable
    - `content_type` string, nullable
    - `run_id` string, uuid, nullable
    - `angle_slug` string, nullable
    - `item_id` string, nullable
    - `source` 'upload' | 'avatar' | 'media' | 'library', nullable
    - `role` 'avatar' | 'reference', nullable
    - `asset_id` string, nullable
  - `context` SandboxContextDTO: Where the sandbox is embedded: the brand it generates for and, optionally, a Video Agent project whose clips Edit with Claude can work on.
    - `domain_id` string, nullable
    - `project_id` integer, nullable
  - `model` string, nullable

## Response `200`

Successful Response

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-11-12** `632983b2dd58`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/creative-sandbox/chat/post.md)

---

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