---
title: "Create Conversation"
method: POST
path: "/api/v1/chat-ai/conversations"
tags: ["chat-ai", "conversations"]
---

# Create Conversation

`POST /api/v1/chat-ai/conversations`

Create a new conversation with a chat agent.

## Request body

- ConversationCreate — Schema for creating a Conversation.
  - `chat_agent_id` string, uuid, required
  - `title` string, nullable
  - `investigation_ids` string[], nullable
  - `data_context` string, nullable
  - `property_id` string, uuid, nullable

## Response `201`

Successful Response

- ConversationRead — Schema for reading a Conversation.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `user_id` string, uuid, nullable
  - `chat_agent_id` string, uuid, required
  - `property_id` string, uuid, nullable
  - `action_item_id` string, uuid, nullable
  - `title` string, nullable, required
  - `preview` string, nullable, required
  - `last_message_at` string, date-time, nullable, required
  - `message_count` integer, required
  - `langgraph_thread_id` string, nullable, required
  - `investigation_context` string, nullable
  - `channel` string
  - `external_conversation_id` string, nullable
  - `external_thread_key` string, nullable
  - `integration_connection_id` string, uuid, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-15** `41c5e4645524` — 1 info
  - added the optional property `action_item_id` to the response with the `201` status
- **2026-09-09** `14d0341c60b5` — 2 breaking, 4 info
  - the response property `user_id` became optional for the status `201`
  - response property `user_id` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - added the optional property `channel` to the response with the `201` status
  - added the optional property `external_conversation_id` to the response with the `201` status
  - …2 more
- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/chat-ai/conversations/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/d782acd3a884?raw)