---
title: "Director Chat Endpoint"
method: POST
path: "/director-chat/message"
tags: ["director-chat"]
---

# Director Chat Endpoint

`POST /director-chat/message`

## Request

- Base URL: `https://api.framesail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.framesail.com/director-chat/message`
- Auth: HTTP bearer

Process a natural-language director chat message and return scene mutations.

## Request body

- DirectorChatRequest
  - `scene_id` string, required
  - `message` string, required
  - `selected_layer_id` string, nullable
  - `conversation_history` ChatMessage[]
    - `role` string, required
    - `content` string, required
  - `scene_composition` object, nullable

## Response `200`

Successful Response

- DirectorChatResponse
  - `mutations` object[], required
  - `skipped_mutations` object[]
  - `summary` string, required
  - `updated_scene` object, required
  - `undoable` boolean, required
  - `follow_up_suggestions` string[]

## Other responses

- `422`: Validation Error

---

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