Current - 2026/09
Endpoint
GET
/v2/stable/api-tool-variable

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.

Request
Response

Authentication

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
StableAPIToolVariableV2 — see its attributes above
Current - 2026/09
Endpoint
POST
/v2/stable/api-tool-variable

Adds an API tool variable to its API tool, an input an API tool substitutes into its request. The response carries the ID that later calls address it by.

Request
Response

Authentication

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).

Request body

name
string
required

The name of the variable, referenced within the API tool request as {name}. Letters, digits and underscores only, at most 64 characters.

apiToolID
string
required

The ID of the API tool this variable belongs to.

description
string

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

Response

201 - application/json

Creates the API tool variable and returns it, including its new ID and the apiToolID of the API tool it now belongs to.

variable
object
required
StableAPIToolVariableV2 — see its attributes above
Current - 2026/09
Endpoint
POST
/v2/stable/api-tool-variable/batch

Adds several API tool variables to its API tool in one request, each taking the fields the single-create call takes. The response carries the created API tool variables in the same shape the list call returns.

Request
Response

Authentication

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).

Request body

apiToolID
string
required

The ID of the API tool to create the variables under.

variables
object[]
required

Response

201 - application/json

Returns the newly created API tool variables, each with its own ID and the apiToolID of the API tool it was attached to.

variables
object[]
required
StableAPIToolVariableV2 — see its attributes above
Endpoint
DELETE
/v1/stable/api-tool-variable/{variableID}

Deletes a single API tool variable by ID. An API tool variable is an input an API tool substitutes into its request. The response carries only a confirmation message, so refetch the API tool variables to see what is left.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

variableID
string
required

The ID of the variable to operate on.

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).

Response

200 - application/json

Confirms the API tool variable was deleted. Nothing but a message is returned, so refetch the tool's variables to see which names its request can still reference.

message
string
required

A human-readable message confirming the deletion.

Current - 2026/09
Endpoint
GET
/v2/stable/api-tool-variable/{variableID}

Returns a single API tool variable by ID, with the fields that define it. An API tool variable is an input an API tool substitutes into its request.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

variableID
string
required

The ID of the variable to operate on.

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).

Response

200 - application/json

Returns a single API tool variable, with the name its tool's request references, the description that tells the agent what value to supply, and the ID of the API tool that owns it.

variable
object
required
StableAPIToolVariableV2 — see its attributes above
Current - 2026/09
Endpoint
PATCH
/v2/stable/api-tool-variable/{variableID}

Changes an existing API tool variable in place. The response carries only a confirmation message, so refetch the API tool variable to read its new values.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

variableID
string
required

The ID of the variable to operate on.

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).

Request body

name
string

The name of the variable, referenced within the API tool request as {name}. Letters, digits and underscores only, at most 64 characters.

description
string

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

Response

200 - application/json

Confirms the API tool variable was updated. The body is a confirmation rather than the updated variable, so fetch the variable again to see its current name and description.

message
string
required

A human-readable message confirming the update.

Schemas

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.