Voiceflow bearer token
Create many tools
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/tool/batch \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"type": "api",
"target": {
"global": true,
"playbookID": "<string>"
},
"tools": [
{
"description": "<string>",
"messages": null,
"captureInputVariables": {},
"asyncExecution": false,
"inputVariables": {},
"captureResponse": {},
"apiToolID": "<string>"
}
]
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/tool/batch?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "api",
"target": {
"global": true,
"playbookID": "<string>"
},
"tools": [
{
"description": "<string>",
"messages": null,
"captureInputVariables": {},
"asyncExecution": false,
"inputVariables": {},
"captureResponse": {},
"apiToolID": "<string>"
}
]
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/tool/batch?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"type": "api",
"target": {
"global": True,
"playbookID": "<string>"
},
"tools": [
{
"description": "<string>",
"messages": None,
"captureInputVariables": {},
"asyncExecution": False,
"inputVariables": {},
"captureResponse": {},
"apiToolID": "<string>"
}
]
},
)
data = response.json()vf tool create-many --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"tools": [
{
"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": {}
}
]
}Adds several tools to the environment in one request, each taking the fields the single-create call takes. The response carries the created tools in the same shape the list call returns.
POST
/v1/stable/tool/batch
Create many tools
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/tool/batch \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"type": "api",
"target": {
"global": true,
"playbookID": "<string>"
},
"tools": [
{
"description": "<string>",
"messages": null,
"captureInputVariables": {},
"asyncExecution": false,
"inputVariables": {},
"captureResponse": {},
"apiToolID": "<string>"
}
]
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/tool/batch?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"type": "api",
"target": {
"global": true,
"playbookID": "<string>"
},
"tools": [
{
"description": "<string>",
"messages": null,
"captureInputVariables": {},
"asyncExecution": false,
"inputVariables": {},
"captureResponse": {},
"apiToolID": "<string>"
}
]
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/tool/batch?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"type": "api",
"target": {
"global": True,
"playbookID": "<string>"
},
"tools": [
{
"description": "<string>",
"messages": None,
"captureInputVariables": {},
"asyncExecution": False,
"inputVariables": {},
"captureResponse": {},
"apiToolID": "<string>"
}
]
},
)
data = response.json()vf tool create-many --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"tools": [
{
"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
Query Parameters
Body
Show child attributes
Option 1
Show child attributes
Show child attributes
Option 2
Show child attributes
Option 3
Show child attributes
Option 4
Show child attributes
Response
201 - application/jsonAttaches several tools to the same target in one call and returns each attachment with its generated ID. The request carries a single type and a single target, so tools of different types need separate calls.
Show child attributes
Option 1
Show child attributes
Option 2
Show child attributes
Option 3
Show child attributes
Option 4
Show child attributes
Was this page helpful?
Thanks for your feedback.