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

# Create response (sync or streamed)

`POST /agents/{agentId}/conversations/{conversation_id}/response`

## Path parameters

- `agentId` string, required
- `conversation_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' | 'error', required
  - `message` string, required
  - `chart` Chart — Charts use vega V5 spec https://vega.github.io/schema/vega/v5.json
  - `table` Table
    - `head` string[], required
    - `body` array[], required
      - string[]

---

[API](https://skmtc.net/inconvoai/apis/inconvo-conversations-api.md) · [All operations](https://skmtc.net/inconvoai/apis/inconvo-conversations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inconvoai/inconvo-conversations-api/revisions/2524aa5bde1f/schema)