---
title: "Rename Conversation"
method: POST
path: "/conversations/{conversation_id}/name"
tags: ["Conversations"]
---

# Rename Conversation

`POST /conversations/{conversation_id}/name`

**Available for**: Chatflow, New Agent, Chatbot, Agent apps.

Renames a conversation, or auto-generates a name from its messages when `auto_generate` is `true`. The name is what clients display in a multi-conversation list.

## Path parameters

- `conversation_id` string, required

## Request body

- ConversationRenameRequest — Request body for renaming a conversation.
  - `name` string — New conversation name. Required unless `auto_generate` is `true`.
  - `auto_generate` boolean — Automatically generate the conversation name. When `true`, the `name` field is ignored.
  - `user` string — End-user identifier, defined by your app and unique within it. See [End User Identity](/en/api-reference/guides/end-user-identity).

## Response `200`

Conversation renamed successfully.

- ConversationListItem
  - `id` string, uuid — Conversation ID.
  - `name` string — Conversation name.
  - `inputs` object — Input variables for the conversation.
  - `status` string — Conversation status. `normal` for active conversations.
  - `introduction` string — Conversation introduction.
  - `created_at` integer — Creation timestamp.
  - `updated_at` integer — Last update timestamp.

## Other responses

- `400` — - `not_chat_app` : App mode does not match the API route. - `invalid_param` : `auto_generate` is `true` but the conversation has no messages to generate a name from.
- `404` — `not_found` : Conversation does not exist.

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/e49b3db72bad/schema)