---
title: "Create response (sync or streamed)"
method: POST
path: "/conversations/{id}/response"
tags: ["Responses"]
---

# Create response (sync or streamed)

`POST /conversations/{id}/response`

## Path parameters

- `id` string, required

## Request body

- object
  - `message` string, required
  - `stream` boolean — If true and the client sets `Accept: text/event-stream`, the API returns an SSE stream instead of a single JSON body.

## Response `200`

• `application/json` → completed response.  
• `text/event-stream` → SSE stream of events.

- InconvoResponse
  - `id` string, required
  - `conversationId` string, required
  - `type` 'text' | 'chart' | 'table', required
  - `message` string, required
  - `chart` Chart
    - `type` 'line' | 'bar', required
    - `title` string, required
    - `xLabel` string, required
    - `yLabel` string, required
    - `data` ChartDatum[], required
      - `label` string, required
      - `value` number, double, required
  - `table` Table
    - `head` string[], required
    - `body` array[], required
      - string[]

## Changes

- **2025-10-23** `a37f8029e8fa` — 1 breaking, 3 info
  - added `#/components/schemas/ResponseProgressEvent` to the `items/` response property `oneOf` list for the response status `200`
  - added `response.progress` discriminator mapping keys to the `items/` response property for the response status `200`
  - removed `agent_step` discriminator mapping keys from the `items/` response property for the response status `200`
  - removed `#/components/schemas/ResponseAgentStepEvent` from the `items/` response property `oneOf` list for the response status `200`

[Change history](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/changes/conversations/:id/response/post.md)

---

[API](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api.md) · [All operations](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/revisions/a37f8029e8fa?raw)