Voiceflow bearer token
Get API tool
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/api-tool/<toolID> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/api-tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'GET',
headers: {
Authorization: 'Bearer <token>',
},
});
const data = await response.json();import requests
response = requests.get(
'https://realtime-api.voiceflow.com/v1/stable/api-tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf api-tool get --tool-id <toolID> --project-id <projectID> --environment-alias <environmentAlias>{
"apiTool": {
"id": "<string>",
"name": "<string>",
"url": [
"<string>"
],
"body": "<APIToolRawBody>",
"image": "<string>",
"headers": [
{
"key": "<string>",
"value": "<Markup>"
}
],
"settings": {
"timeoutMs": 0
},
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"httpMethod": "get",
"description": "<string>",
"queryParameters": [
{
"key": "<string>",
"value": "<Markup>"
}
]
}
}Returns a single API tool by ID, with the fields that define it. An API tool is a saved HTTP request an agent can make.
GET
/v1/stable/api-tool/{toolID}
Get API tool
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/api-tool/<toolID> \
--header 'Authorization: Bearer <token>'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/api-tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'GET',
headers: {
Authorization: 'Bearer <token>',
},
});
const data = await response.json();import requests
response = requests.get(
'https://realtime-api.voiceflow.com/v1/stable/api-tool/<toolID>?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
)
data = response.json()vf api-tool get --tool-id <toolID> --project-id <projectID> --environment-alias <environmentAlias>{
"apiTool": {
"id": "<string>",
"name": "<string>",
"url": [
"<string>"
],
"body": "<APIToolRawBody>",
"image": "<string>",
"headers": [
{
"key": "<string>",
"value": "<Markup>"
}
],
"settings": {
"timeoutMs": 0
},
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"httpMethod": "get",
"description": "<string>",
"queryParameters": [
{
"key": "<string>",
"value": "<Markup>"
}
]
}
}Authorizations
Query Parameters
Response
200 - application/jsonReturns a single API tool, with the complete request it sends: HTTP method, URL, headers, query parameters, and body, plus any settings saved on it.
Show child attributes
Was this page helpful?
Thanks for your feedback.