Create tool
Adds a tool to the environment, something a playbook can call during a conversation. The response carries the ID that later calls address it by.
Authorizations
Voiceflow bearer token
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 The ID of the API resource this tool executes.
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
Attaches an existing API tool, function, or MCP tool 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.
- Option 1
- Option 2
- Option 3