Send Messages

Send a message in a chat session and receive the assistant's response, including tool calls and interactions.

POST/api/v1/chats/{chatId}/messages

Request Body

Parameter	Type	Required	Description
message	string	Yes	The user message to send
mediaIds	string[]	No	Media IDs to attach to the message
qualityTier	string	No	`"standard"` \| `"high"` \| `"max"`
passthroughPrompt	boolean	No	Disable AI prompt rewriting (verbatim mode). See Verbatim Mode page
skillId	string	No	Target a specific agent skill
styleId	string	No	Apply a style to generated media
blueprintId	string	No	Scope the message to a blueprint context
recipeSlug	string	No	Use a predefined recipe for the message
aspectRatio	string	No	Desired aspect ratio for generated media

Response

Response shape

{
  "status": "complete",
  "assistantText": "Here's your product video!",
  "toolCalls": [
    {
      "toolName": "generateVideo",
      "toolCallId": "tc_xyz789",
      "args": { "prompt": "..." },
      "result": { "mediaId": "media_out_1" }
    }
  ],
  "interaction": null,
  "error": null
}

Status Values

Status	Description
`complete`	The assistant finished processing. Check assistantText and toolCalls
`interaction_required`	The assistant needs more input. See the Interactions page
`error`	An error occurred. Check the error field for details

Example

POST/api/v1/chats/{chatId}/messages

{
  "message": "Create a 15-second product demo video",
  "mediaIds": ["media_product_img"],
  "qualityTier": "high",
  "aspectRatio": "16:9"
}