curl --request GET \
--url 'https://api.voice.stateset.com/tools' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 2,
"tools": [
{
"definition": {
"description": "Look up the current status of an order",
"name": "get_order",
"parameters": {
"properties": {
"order_id": {
"description": "Order ID like ORD-12345",
"type": "string"
}
},
"required": [
"order_id"
],
"type": "object"
},
"type": "function"
},
"name": "get_order"
},
{
"definition": {
"description": "Transfer the current call to a human agent",
"name": "escalate_call_to_human",
"parameters": {
"properties": {
"reason": {
"type": "string"
},
"target_number": {
"description": "E.164 target number",
"type": "string"
}
},
"required": [
"target_number"
],
"type": "object"
},
"type": "function"
},
"name": "escalate_call_to_human"
}
]
}
Tools
Automation endpoint used by voice agents and trusted clients to execute workflow actions or retrieve evaluation results.
GET
/
tools
curl --request GET \
--url 'https://api.voice.stateset.com/tools' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 2,
"tools": [
{
"definition": {
"description": "Look up the current status of an order",
"name": "get_order",
"parameters": {
"properties": {
"order_id": {
"description": "Order ID like ORD-12345",
"type": "string"
}
},
"required": [
"order_id"
],
"type": "object"
},
"type": "function"
},
"name": "get_order"
},
{
"definition": {
"description": "Transfer the current call to a human agent",
"name": "escalate_call_to_human",
"parameters": {
"properties": {
"reason": {
"type": "string"
},
"target_number": {
"description": "E.164 target number",
"type": "string"
}
},
"required": [
"target_number"
],
"type": "object"
},
"type": "function"
},
"name": "escalate_call_to_human"
}
]
}
Automation endpoint used by voice agents and trusted clients to execute workflow actions or retrieve evaluation results.
Response
ToolsResponse
integer
required
Total number of registered tools
ToolEntry[]
required
Status codes
| Code | Meaning |
|---|---|
200 | List available AI tools/functions |
401 | Unauthorized |
curl --request GET \
--url 'https://api.voice.stateset.com/tools' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 2,
"tools": [
{
"definition": {
"description": "Look up the current status of an order",
"name": "get_order",
"parameters": {
"properties": {
"order_id": {
"description": "Order ID like ORD-12345",
"type": "string"
}
},
"required": [
"order_id"
],
"type": "object"
},
"type": "function"
},
"name": "get_order"
},
{
"definition": {
"description": "Transfer the current call to a human agent",
"name": "escalate_call_to_human",
"parameters": {
"properties": {
"reason": {
"type": "string"
},
"target_number": {
"description": "E.164 target number",
"type": "string"
}
},
"required": [
"target_number"
],
"type": "object"
},
"type": "function"
},
"name": "escalate_call_to_human"
}
]
}