---
title: "Chat Stream"
method: POST
path: "/agents/v1/{api_key}/chat/stream"
tags: ["agents"]
---

# Chat Stream

`POST /agents/v1/{api_key}/chat/stream`

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/agents/v1/{api_key}/chat/stream`
- Auth: none declared

Stream chat events from Nova OS via SSE.

Each SSE event is a JSON object matching the Nova OS pipeline event shape:
  data: {"type": "text", "text": "..."}
  data: {"type": "tool_use", "name": "...", "input": {...}}
  data: {"type": "tool_result", "content": "..."}
  data: {"type": "thinking", "thinking": "..."}
  data: {"type": "done", "response": "...", "conversation_id": "..."}
  data: [DONE]

Falls back to a single synthetic "done" event when the agent is not
registered in Nova OS or the backend is MESH_BACKEND=ang.

## Path parameters

- `api_key` string, required

## Request body

- AgentChatRequest: Request to chat with an agent.
  - `message` string, required
  - `user_identifier` string, nullable
  - `user_identifier_type` string, nullable
  - `conversation_id` string, uuid, nullable
  - `extra_data` object, nullable
  - `attachments` object[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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