{ "tool": { "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

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

type

enum<string>

required

The type of the tool to fetch.

Available options: api, mcp, function, integration

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 three shapes, API, function, or MCP, comes back.

tool

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

Get tool

Authorizations

Path Parameters

Query Parameters

Response

Getting started

Running agents

Build

Manage

Publishing

Observe

Insights

QA

Analytics

Webhooks