Search skmtc

Annotations6

Applications4

Audio2

Chat Messages3

Chunks9

Completion Messages2

Conversations6

Documents12

End Users1

Feedback2

Files2

Human Input2

Knowledge Bases6

Knowledge Pipeline4

Metadata7

Models1

Tags7

Workflow Runs6

Conversations

List Conversation Messages

Changed on Oct 23, 2026

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

Returns a conversation's message history, newest first. Pass first_id to page backward into older messages.

get/messages

Request

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

Query parameters

conversation_idstring required

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

userstring

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

first_idstring

Pagination cursor: the id of the first message on the current page. Pass it to fetch the previous (older) page; omit to fetch the latest messages.

limitinteger

Number of chat history messages to return per request.

Response

Successfully retrieved conversation history.

has_moreboolean

Whether there are more messages.

limitinteger

Number of items per page.

Changes

Oct 23, 20269b8ecd70c860 Revision changes
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
Jul 11, 20261647da477789 Revision changes
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history