Update tool
Changes an existing tool in place. The response carries only a confirmation message, so refetch the tool to read its new values.
Authorizations
Voiceflow bearer token
Path Parameters
The ID of the tool to operate on.
Query Parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Body
- Option 1
- Option 2
- Option 3
Discriminator indicating this tool executes a saved API request.
api A description of what the tool does, used by the agent to decide when to call it.
A map of tool input names to the variables or entities whose values are captured into them.
When enabled, the tool runs in the background without blocking the conversation.
A map of input names to the values the agent supplies when calling the tool.
A map of variable names to the parts of the tool response captured into them.
Response
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.
A human-readable message confirming the update.