Send a chat message
Send a natural language message to the LLM chat backend for a specific workflow. The request includes the current workflow state and optional conversation history so the LLM can generate contextually relevant responses. The LLM response may contain plain text explanations and/or DSL commands in ```flowdrop fenced code blocks. The frontend extracts and previews these commands before execution.
JWT token for authentication
In: header
Path Parameters
Workflow ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request payload for sending a chat message
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/workflows/string/chat/messages" \ -H "Content-Type: application/json" \ -d '{ "message": "Add a processing node called \\"transform\\"", "workflowState": { "nodes": [], "edges": [] } }'{ "success": true, "data": { "content": "I'll add a processing node and connect it to your start node.\n\n```flowdrop\nadd transform processing\nconnect start:output transform:input\n```\n", "conversationId": "conv-abc123" }}Get chat conversation history GET
Retrieve the conversation history for a workflow's chat session. Returns an array of messages with role (user/assistant) and content.
Get category definitions GET
Retrieve all available category definitions including display labels, icons, colors, and ordering. Categories determine how nodes are organized in the sidebar. Built-in categories are always available as defaults. This endpoint allows overriding built-in category metadata and defining custom categories.