Dify Octri Demo
GET/conversations

List Conversations

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

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

4 parameters
userstringoptional
End-user identifier, defined by your app and unique within it. See [End User Identity](/en/api-reference/guides/end-user-identity).
last_idstringoptional
Pagination cursor: the `id` of the last conversation on the current page. Omit to fetch the first page.
limitintegeroptional
Number of records to return.
Default:20
sort_bystringoptional
Field to sort by. Prefix with `-` for descending order.
Allowed:created_at-created_atupdated_at-updated_atDefault:-updated_at

3 status codes
200Successfully retrieved conversations list.
dataarray<object>optional
List of conversations.
has_morebooleanoptional
Whether there are more conversations.
limitintegeroptional
Number of items per page.
400`not_chat_app` : App mode does not match the API route.

One documented failure

  • not_chat_app

    Please check if your app mode matches the right API route.

    not_chat_app

404`not_found` : Last conversation does not exist (invalid `last_id`).

One documented failure

  • not_found

    Last Conversation Not Exists.

    not_found

Error handling

A 400 is returned: not_chat_app : App mode does not match the API route. A 404 is returned: not_found : Last conversation does not exist (invalid last_id).