List variables

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

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

import requests

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

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

List variables

Returns every function variable in its function. A function variable is an input or output a function declares. The call takes no paging parameters, so one request yields the whole set.

GET

/v1/stable/function-variable

List variables

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

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

import requests

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

{
  "variables": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "input",
      "createdAt": "2026-09-10T00:00:00.000Z",
      "updatedAt": "2026-09-10T00:00:00.000Z",
      "functionID": "<string>",
      "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).

functionID

string

required

The ID of the function whose variables to list.

Response

200 - application/json

Returns every variable declared on a single function, selected by the functionID query parameter, each marked as an input or an output and named as the function code references it.

variables

object[]

required

Show child attributes

string

required

name

string

required

The name used to reference the variable in the function code.

type

object

required

Available options: input, output

createdAt

string

required

updatedAt

string

required

functionID

string

required

The ID of the function this variable belongs to.

description

string

required

A human-readable description of what the variable holds.

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