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

Returns every tool in the environment, including workflow tools. A tool is something a playbook can call during a conversation. 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

global
boolean

Target the agent. Cannot be used with playbookID.

playbookID
string

Target a specific playbook. Cannot be used with global.

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

type
enum<string>

When provided, only tools of this type are returned. workflow returns the workflow tools.

Available options: api, mcp, function, integration, workflow

Response

200 - application/json

Returns the tools attached to the agent or to a single playbook, depending on whether you pass global or playbookID. Each entry is the attachment rather than the underlying resource: it points at an API tool, function, MCP tool, integration tool or workflow by ID and carries the description, input mappings, and response capture used when the agent calls it.

tools
object[]
required
StableToolListItemV2 — see its attributes above
Current - 2026/09
Endpoint
POST
/v2/stable/tool

Adds a tool to the environment, or gives the agent a workflow tool. A tool is something a playbook can call during a conversation. Message text and default input values are plain strings, and 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

Response

201 - application/json

Attaches an existing API tool, function, MCP tool, integration tool or workflow to the agent or to a playbook, and returns the attachment with its generated ID and wiring. The underlying resource is referenced by ID and is not created here.

tool
object
required
StableToolAttachmentV2 — see its attributes above
unresolvedReferences
object[]

References this write kept as literal text instead of binding, each with the reason. The write still succeeded.

StableUnresolvedReference — see its attributes above
Current - 2026/09
Endpoint
POST
/v2/stable/tool/batch

Adds several tools to the environment in one request, each taking the fields the single-create call takes, with message text and default input values as plain strings. The response carries the created tools 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

Response

201 - application/json

Attaches several tools to the same target in one call and returns each attachment with its generated ID. The request carries a single type and a single target, so tools of different types need separate calls.

tools
object[]
required
StableToolV2 — see its attributes above
unresolvedReferences
object[]

References this write kept as literal text instead of binding, each with the reason. The write still succeeded.

StableUnresolvedReference — see its attributes above
Current - 2026/09
Endpoint
GET
/v2/stable/tool/{toolID}

Returns a single tool by ID, including a workflow tool, with the fields that define it. A tool is something a playbook can call during a conversation.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

toolID
string
required

The ID of the tool 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).

type
enum<string>
required

The type of the tool to fetch.

Available options: api, mcp, function, integration, workflow

Response

200 - application/json

Returns one attached tool with the resource it points at, the description the agent reads, its input mappings, and where its response is captured. The required type parameter selects which of the five shapes, API, function, MCP, integration or workflow, comes back.

tool
object
required
StableToolAttachmentV2 — see its attributes above
Current - 2026/09
Endpoint
PATCH
/v2/stable/tool/{toolID}

Changes an existing tool attachment in place, taking message text and default input values as plain strings. The response lists any references that did not resolve; read the tool again to see its new values.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

toolID
string
required

The ID of the tool 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

Response

200 - application/json

Confirms the attachment's wiring was updated, meaning its description, input mappings, or capture settings rather than the API tool, function, or MCP tool it points at. The body is a message only, so refetch the tool to read its current state.

message
string
required

A human-readable message confirming the update.

unresolvedReferences
object[]

References this write kept as literal text instead of binding, each with the reason. The write still succeeded.

StableUnresolvedReference — see its attributes above
Current - 2026/10
Endpoint
DELETE
/v2/stable/tool/{toolID}

Deletes a single tool by ID, including a workflow tool. A tool is something a playbook can call during a conversation. The response carries only a confirmation message, so refetch the tools to see what is left.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

toolID
string
required

The ID of the tool 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).

type
enum<string>
required

The type of the tool to delete. workflow removes a workflow tool; the workflow stays.

Available options: api, mcp, function, integration, workflow

Response

200 - application/json

Confirms the tool was deleted. The body is a message only, so refetch the agent's or playbook's tools to see what it can still call.

message
string
required

A human-readable message confirming the deletion.

Endpoint
POST
/v1/stable/tool/{toolID}/move

Move a tool attachment to the agent or to a playbook. It keeps its ID, its fields and its messages.

Request
Response

Authentication

Authorization
string
header
required

Voiceflow bearer token

Path parameters

toolID
string
required

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

type
enum<string>
required

The type of the tool to move. workflow is refused: a workflow tool stays on the agent.

Available options: api, mcp, function, integration, workflow
target
object
required
StableToolTarget — see its attributes above

Response

200 - application/json
tool
object
required
StableToolV2 — see its attributes above

Schemas

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