{ "tools": [ { "id": "<string>", "createdAt": "2026-09-10T00:00:00.000Z", "updatedAt": "2026-09-10T00:00:00.000Z", "messages": "<AgentToolMessages>", "description": "<string>", "captureInputVariables": {}, "type": "api", "apiToolID": "<string>", "asyncExecution": true, "inputVariables": {}, "captureResponse": {} } ] }

Authorizations

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.

Available options: api, mcp, function, integration

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, or MCP tool by ID and carries the description, input mappings, and response capture used when the agent calls it.

tools

object[]

required

Show child attributes

Option 1

Show child attributes

string

required

createdAt

string

required

updatedAt

string

required

messages

object

required

Show child attributes

generative

object

object · 4 attributes: delay, failure, execution, completion

delayMessageID

string

required

failureMessageID

string

required

executionMessageID

string

required

completionMessageID

string

required

delayMessageSeconds

number

required

description

string

required

A description of what the tool does, used by the agent to decide when to call it.

captureInputVariables

object

required

A map of tool input names to the variables or entities whose values are captured into them.

type

enum<string>

required

Discriminator indicating this tool executes a saved API request.

Available options: api

apiToolID

string

required

The ID of the API resource this tool executes.

asyncExecution

boolean

required

When enabled, the tool runs in the background without blocking the conversation.

inputVariables

object

required

A map of input names to the values the agent supplies when calling the tool.

captureResponse

object

required

A map of variable names to the parts of the tool response captured into them.

Option 2

Show child attributes

string

required

createdAt

string

required

updatedAt

string

required

messages

object

required

Show child attributes

generative

object

object · 4 attributes: delay, failure, execution, completion

delayMessageID

string

required

failureMessageID

string

required

executionMessageID

string

required

completionMessageID

string

required

delayMessageSeconds

number

required

description

string

required

A description of what the tool does, used by the agent to decide when to call it.

captureInputVariables

object

required

A map of tool input names to the variables or entities whose values are captured into them.

type

enum<string>

required

Discriminator indicating this tool executes a custom function.

Available options: function

functionID

string

required

The ID of the function resource this tool executes.

asyncExecution

boolean

required

When enabled, the tool runs in the background without blocking the conversation.

inputVariables

object

required

A map of input names to the values the agent supplies when calling the tool.

captureResponse

object

required

A map of variable names to the parts of the tool response captured into them.

Option 3

Show child attributes

string

required

createdAt

string

required

updatedAt

string

required

messages

object

required

Show child attributes

generative

object

object · 4 attributes: delay, failure, execution, completion

delayMessageID

string

required

failureMessageID

string

required

executionMessageID

string

required

completionMessageID

string

required

delayMessageSeconds

number

required

description

string

required

A description of what the tool does, used by the agent to decide when to call it.

captureInputVariables

object

required

A map of tool input names to the variables or entities whose values are captured into them.

type

enum<string>

required

Discriminator indicating this tool calls a tool from an MCP server.

Available options: mcp

mcpToolID

string

required

The ID of the MCP tool resource this tool calls.

inputVariables

object

required

A map of input names to the values the agent supplies when calling the tool.

captureResponse

object

required

A map of variable names to the parts of the tool response captured into them.

Option 4

Show child attributes

string

required

createdAt

string

required

updatedAt

string

required

messages

object

required

Show child attributes

generative

object

object · 4 attributes: delay, failure, execution, completion

delayMessageID

string

required

failureMessageID

string

required

executionMessageID

string

required

completionMessageID

string

required

delayMessageSeconds

number

required

description

string

required

A description of what the tool does, used by the agent to decide when to call it.

captureInputVariables

object

required

A map of tool input names to the variables or entities whose values are captured into them.

type

enum<string>

required

Discriminator indicating this tool calls a connected first-party integration.

Available options: integration

integrationToolID

string

required

The ID of the integration tool resource this tool calls.

inputVariables

object

required

A map of input names to the values the agent supplies when calling the tool.

captureResponse

object

required

A map of variable names to the parts of the tool response captured into them.

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks

List tools

Authorizations

Query Parameters

Response

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks