Custom Tools
List Custom Tools
Calls
Intelligence
Conversational Pathways
- GETGet All Pathways Information
- GETGet Single Pathway Information
- POSTCreate Pathway
- POSTUpdate Pathway
- DELDelete Pathway
- Pathway Chat
- Pathway Versions
- Pathway Folders
Vector Knowledge Bases
Voices
Custom Tools
Web Agents
Custom Twilio Accounts
Batches
SMS
Account
Organizations
- POSTCreate Organization
- DELDelete Organization
- GETGet Organization
- GETGet Organization Members
- GETGet Organization's Current Service Version
- GETList Organization's Service Versions
- PATCHUpdate Organization's Service Version
- PATCHUpdate Organization Members
- PATCHUpdate Organization Member Permissions
- PATCHUpdate Organization Properties
- GETGet User Organization Memberships
- DELLeave Organization
- GETGet Organization Billing Information
- GETGet Organization Billing Refill Information
Custom Tools
List Custom Tools
Retrieve Custom Tools you’ve created.
GET
/
v1
/
tools
curl --request GET \
--url https://api.bland.ai/v1/tools \
--header 'authorization: <authorization>'
{
"status": "success",
"tools": [
{
"tool_id": "TL-5da8347d-0ab7-415d-b156-a7fc5c6074dc",
"label": null,
"tool": {
"name": "BookAppointment",
"description": "Books the appointment. Can only be used once.",
"speech": "Please wait while I book that appointment for you",
"method": "POST",
"timeout": 99999999,
"url": "https://...",
"body": {
"slot": "{{input}}"
},
"input_schema": {
"type": "object",
"example": {
"date": "2024-03-16",
"time": "5:00 PM"
},
"required": [
"date",
"time"
],
"properties": {
"date": "YYYY-MM-DD",
"time": "HH:MM (AM|PM)"
}
},
"response": {
"confirmation_message": "$.message"
}
},
"public": false
},
...
]
}
Headers
Your API key for authentication.
Response
Whether the requet succeeded or failed.
An array of your available tools.
{
"status": "success",
"tools": [
{
"tool_id": "TL-5da8347d-0ab7-415d-b156-a7fc5c6074dc",
"label": null,
"tool": {
"name": "BookAppointment",
"description": "Books the appointment. Can only be used once.",
"speech": "Please wait while I book that appointment for you",
"method": "POST",
"timeout": 99999999,
"url": "https://...",
"body": {
"slot": "{{input}}"
},
"input_schema": {
"type": "object",
"example": {
"date": "2024-03-16",
"time": "5:00 PM"
},
"required": [
"date",
"time"
],
"properties": {
"date": "YYYY-MM-DD",
"time": "HH:MM (AM|PM)"
}
},
"response": {
"confirmation_message": "$.message"
}
},
"public": false
},
...
]
}
curl --request GET \
--url https://api.bland.ai/v1/tools \
--header 'authorization: <authorization>'
{
"status": "success",
"tools": [
{
"tool_id": "TL-5da8347d-0ab7-415d-b156-a7fc5c6074dc",
"label": null,
"tool": {
"name": "BookAppointment",
"description": "Books the appointment. Can only be used once.",
"speech": "Please wait while I book that appointment for you",
"method": "POST",
"timeout": 99999999,
"url": "https://...",
"body": {
"slot": "{{input}}"
},
"input_schema": {
"type": "object",
"example": {
"date": "2024-03-16",
"time": "5:00 PM"
},
"required": [
"date",
"time"
],
"properties": {
"date": "YYYY-MM-DD",
"time": "HH:MM (AM|PM)"
}
},
"response": {
"confirmation_message": "$.message"
}
},
"public": false
},
...
]
}