---
title: "Agentic Stream"
method: POST
path: "/api/agentic/stream"
tags: ["Chat"]
---

# Agentic Stream

`POST /api/agentic/stream`

## Request

- Base URL: `https://app.getdot.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.getdot.ai/api/agentic/stream`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in cookie `Authorization`
  - OAuth 2 (password, token URL `/api/auth/token`)

Send a message to an agentic conversation and stream responses via SSE.

`preview` is what the app editor's preview showed as the message was sent (AppPreview.vue).

## Request body

- BodyAgenticStreamApiAgenticStreamPost
  - `new_message` object, required
  - `chat_id` string, required
  - `extra` string, nullable
  - `edit_message_uuid` string, nullable
  - `attached_files` object[], nullable
  - `eval_mode` boolean
  - `report_meta` object, nullable
  - `lineage_parent_id` string, nullable
  - `lineage_source_message_uuid` string, nullable
  - `mode` string, nullable
  - `branch` string
  - `preview` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getdot/apis/dot-api-2.md) · [All operations](https://skmtc.dev/getdot/apis/dot-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/getdot/apis/dot-api-2/revisions/d26fe7163a7f?raw)