Skip to main content
PATCH
Update tool

Authorizations

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

Body

application/json
type
enum<string>
required

Discriminator indicating this tool executes a saved API request.

Available options:
api
description
string | null

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

captureInputVariables
object | null

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

asyncExecution
boolean

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

inputVariables
object

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

captureResponse
object

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

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.