---
title: "Replace conversation messages"
method: PUT
path: "/internal/ai-conversations/{conversationId}/messages"
tags: ["Others"]
---

# Replace conversation messages

`PUT /internal/ai-conversations/{conversationId}/messages`

Replace all messages in a conversation

## Path parameters

- `conversationId` string, required

## Request body

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

## Response `200`

Successful response

- object

## 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/:conversationId/messages/put.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.dev/hexclave/apis/hexclave-rest-api/revisions/e134b68b3b7e?raw)