Conversations

Rename Conversation

Available for: Chatflow, Agent, Chatbot, Legacy 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.

post/conversations/{conversation_id}/name

Request

  • Base URL
    https://api.dify.ai/v1
  • URL
    https://api.dify.ai/v1/conversations/{conversation_id}/name
  • Auth
    HTTP bearer

Path parameters

conversation_idstring required

ID of the conversation to rename. Get conversation IDs from List Conversations.

Request body

auto_generateboolean

Automatically generate the conversation name. When true, the name field is ignored.

namestring

New conversation name. Required unless auto_generate is true.

userstring

End-user identifier, defined by your app and unique within it. See End User Identity.

Response

Conversation renamed successfully.

created_atinteger

Creation timestamp.

idstring uuid

Conversation ID.

inputsobject

Input variables for the conversation.

introductionstring

Conversation introduction.

namestring

Conversation name.

statusstring

Conversation status. normal for active conversations.

updated_atinteger

Last update timestamp.

Changes

No recorded changes to this operation across all 17 revisions of this API.