Conversations

List Conversations

Available for: Chatflow, Agent, Chatbot, Legacy Agent apps.

Lists an end user's conversations, most recently active first.

get/conversations

Request

  • Base URL
    https://api.dify.ai/v1
  • URL
    https://api.dify.ai/v1/conversations
  • Auth
    HTTP bearer

Query parameters

userstring

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

last_idstring

Pagination cursor: the id of the last conversation on the current page. Omit to fetch the first page.

limitinteger

Number of records to return.

sort_by'created_at' | '-created_at' | 'updated_at' | '-updated_at'

Field to sort by. Prefix with - for descending order.

Response

Successfully retrieved conversations list.

has_moreboolean

Whether there are more conversations.

limitinteger

Number of items per page.

Changes

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