---
title: "Workflow Chat"
method: POST
path: "/v3/workflow-editor/chat"
tags: ["workflow-editor"]
---

# Workflow Chat

`POST /v3/workflow-editor/chat`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v3/workflow-editor/chat`
- Auth: HTTP bearer

Send a message to the workflow chat agent.

Returns a Server-Sent Events (SSE) stream with agent responses.
Events include:
- text_delta: Streaming text content
- tool_call: When the agent calls a tool
- tool_result: Result of tool execution
- sync_workflow: Updated workflow state (nodes, edges, YAML)
- error: Error messages
- done: Stream completion

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- WorkflowEditorRequest: Request to send a message to the workflow chat.
  - `message` string, required: User message
  - `draft_id` string, nullable: Existing workflow ID to continue editing. If not provided, creates a new draft.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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