> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Variables API

The Variables API provides read access to the [Variables](/docs/automation/variables) configured for your AI Agent. Variables store information collected during a conversation, such as an end user's email or order number, so it can be reused across the AI Agent's logic.

Download full OpenAPI spec

The API exposes the Variables that appear on the dashboard. Reserved and internal Variables are not returned. Each Variable is identified by an `id`, which is used to reference it from other resources.

## Endpoints

Two read endpoints are available:

* **List Variables** (`GET /v2/variables`): Returns every accessible Variable for the AI Agent.
* **Get a Variable** (`GET /v2/variables/{id}`): Returns a single Variable by its `id`. An unknown, malformed, or reserved `id` returns a `404`.

Both endpoints return each Variable as a summary containing its `id` and `name`.

## Authentication

Requests are authenticated with a Bearer API key. See [Authentication](/reference/introduction/authentication) for details on generating and using API keys.