List variables

curl --request GET \
  --url https://realtime-api.voiceflow.com/v1/stable/api-tool-variable \
  --header 'Authorization: Bearer <token>'

const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/api-tool-variable?projectID=<projectID>&environmentAlias=<environmentAlias>&apiToolID=<apiToolID>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/api-tool-variable?projectID=<projectID>&environmentAlias=<environmentAlias>&apiToolID=<apiToolID>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()

{
  "variables": [
    {
      "id": "<string>",
      "name": "<string>",
      "apiToolID": "<string>",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "description": "<string>"
    }
  ]
}

List variables

Returns every API tool variable in its API tool. An API tool variable is an input an API tool substitutes into its request. The call takes no paging parameters, so one request yields the whole set.

GET

/v1/stable/api-tool-variable

List variables

curl --request GET \
  --url https://realtime-api.voiceflow.com/v1/stable/api-tool-variable \
  --header 'Authorization: Bearer <token>'

const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/api-tool-variable?projectID=<projectID>&environmentAlias=<environmentAlias>&apiToolID=<apiToolID>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();

import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/api-tool-variable?projectID=<projectID>&environmentAlias=<environmentAlias>&apiToolID=<apiToolID>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()

{
  "variables": [
    {
      "id": "<string>",
      "name": "<string>",
      "apiToolID": "<string>",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "description": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Voiceflow bearer token

Query Parameters

projectID

string

required

The ID of the project to operate on.

environmentAlias

string

required

The alias of the environment to operate on (e.g. main).

apiToolID

string

required

The ID of the API tool whose variables to list.

Response

200 - application/json

Returns every variable defined on a single API tool, selected by the apiToolID query parameter rather than across the whole project. Each carries the name the tool's request references and a description telling the agent what value to provide.

variables

object[]

required

Show child attributes

string

required

name

string

required

The name of the variable, referenced within the API tool request.

apiToolID

string

required

The ID of the API tool this variable belongs to.

createdAt

string

required

updatedAt

string

required

description

string

required

A description of the variable, used by the agent to determine what value to provide.

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks

List variables

Authorizations

Query Parameters

Response

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks