---
title: "Create AI conversation"
method: POST
path: "/internal/ai-conversations"
tags: ["Others"]
---

# Create AI conversation

`POST /internal/ai-conversations`

Create a new AI conversation with optional initial messages

## Request body

- object
  - `title` string, required
  - `projectId` string, required
  - `messages` object[], required
    - `role` 'user' | 'assistant', required
    - `content` object, required

## Response `200`

Successful response

- object
  - `id` string, required
  - `title` string, required

## Changes

- **2026-05-15** `f135fd8ca8b4` — 1 breaking, 2 info
  - request property `messages/items/role` was restricted to a list of enum values
  - added the new `assistant` enum value to the request property `messages/items/role`
  - added the new `user` enum value to the request property `messages/items/role`
- **2026-05-06** `7fcc5cbc3884` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hexclave/apis/hexclave-rest-api/changes/internal/ai-conversations/post.md)

---

[API](https://skmtc.dev/hexclave/apis/hexclave-rest-api.md) · [All operations](https://skmtc.dev/hexclave/apis/hexclave-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexclave/hexclave-rest-api/revisions/f135fd8ca8b4/schema)