Skip to main content
POST
Create API tool

Authorizations

Authorization
string
header
required

Voiceflow bearer token

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
name
string
required
httpMethod
enum<string>
required
Available options:
get,
put,
post,
patch,
delete
url
string · object · object · object · object · object[] | null
body
object
settings
object | null
description
string | null

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

headers
object[]
queryParameters
object[]

Response

201 - application/json

Creates the API tool and returns it in full, including its new ID and the request it will send: HTTP method, URL, headers, query parameters, and body.

apiTool
object
required