---
title: "List Conversation Variables"
method: GET
path: "/conversations/{conversation_id}/variables"
tags: ["Conversations"]
---

# List Conversation Variables

`GET /conversations/{conversation_id}/variables`

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

Lists the variables stored in a conversation.

## Path parameters

- `conversation_id` string, required

## Query parameters

- `user` string
- `last_id` string
- `limit` integer
- `variable_name` string

## Response `200`

Successfully retrieved conversation variables.

- ConversationVariablesResponse
  - `limit` integer — Number of items per page.
  - `has_more` boolean — Whether there is a next page.
  - `data` ConversationVariableItem[] — List of conversation variables.
    - `id` string, uuid — Variable ID.
    - `name` string — Variable name.
    - `value_type` string — Variable value type. Possible values: `string`, `number`, `object`, `secret`, `file`, `boolean`, `array[any]`, `array[string]`, `array[number]`, `array[object]`, `array[file]`, `array[boolean]`.
    - `value` string — Variable value (can be a JSON string for complex types).
    - `description` string — Variable description.
    - `created_at` integer — Creation timestamp.
    - `updated_at` integer — Last update timestamp.

## Other responses

- `400` — - `not_chat_app` : App mode does not match the API route. - `invalid_param` : The `last_id` does not match any variable in this conversation.
- `404` — `not_found` : Conversation does not exist.

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/e49b3db72bad/schema)