Conversations

List Conversation Variables

Available for: Chatflow, Chatbot, Legacy Agent apps.

Lists the variables stored in a conversation.

get/conversations/{conversation_id}/variables

Request

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

Path parameters

conversation_idstring required

ID of the conversation whose variables to list. Get conversation IDs from List Conversations.

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 variable on the current page. Omit to fetch the first page.

limitinteger

Number of records to return.

variable_namestring

Filter variables by a specific name.

Response

Successfully retrieved conversation variables.

has_moreboolean

Whether there is a next page.

limitinteger

Number of items per page.

Changes

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