---
title: "Append Insights Chat Message"
method: POST
path: "/v1/insights-chat/sessions/{chat_session_id}/messages"
tags: ["insights-chat"]
---

# Append Insights Chat Message

`POST /v1/insights-chat/sessions/{chat_session_id}/messages`

## Request

- Base URL: `https://api.ontora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ontora.com/v1/insights-chat/sessions/{chat_session_id}/messages`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ontora/apis/ontora-api/docs/v1/insights-chat/sessions/:chat_session_id/messages/post.ts> (a function with typed inputs; its response is checked against the schema)

Persist an untrusted user turn; assistant turns are never public writes.

## Path parameters

- `chat_session_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Request body

- InsightsChatMessageIn
  - `role` 'user' | 'assistant', required
  - `content` string, required
  - `response_payload` object, nullable
  - `client_message_id` string, uuid, nullable
  - `request_message_id` string, uuid, nullable
  - `turn_run_id` string, uuid, nullable

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-07** `d565b1a348d6`: 1 breaking, 1 warning, 4 info
  - request property `role` was restricted to a list of enum values
  - the `content` request property's maxLength was set to `200000`
  - added the new optional request property `request_message_id`
  - added the new optional request property `turn_run_id`
  - …2 more
- **2026-09-01** `7f57037fd94b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ontora/apis/ontora-api/changes/v1/insights-chat/sessions/:chat_session_id/messages/post.md)

---

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