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

# Chat Stream

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

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.net/meganova/apis/fastapi.md) · [All operations](https://skmtc.net/meganova/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meganova/fastapi/revisions/2b2bab8b9017/schema)