import requests
url = "https://api.sayvy.ai/api/v1/agents"
headers = {
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.sayvy.ai/api/v1/agents", {
method: "GET",
headers: {
"Authorization": "Bearer <token>"
}
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sayvy.ai/api/v1/agents"))
.header("Authorization", "Bearer <token>")
.GET()
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X GET "https://api.sayvy.ai/api/v1/agents" \
-H "Authorization: Bearer <token>"
{
"agents": [
{
"id": "agent_12345",
"name": "Sales Assistant",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2024-05-20T10:15:30Z",
"updated_at": "2024-05-22T14:22:10Z"
},
{
"id": "e4b2d184-7cf1-4560-a292-6284649bcf2e",
"name": "Support Concierge",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2026-09-03T12:00:00Z",
"updated_at": "2026-09-03T12:00:00Z"
}
]
}
{
"error": 401,
"message": "Unauthorized"
}
Agents
List agents
Retrieve all Voice AI agents belonging to your organization
GET
/
api
/
v1
/
agents
import requests
url = "https://api.sayvy.ai/api/v1/agents"
headers = {
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.sayvy.ai/api/v1/agents", {
method: "GET",
headers: {
"Authorization": "Bearer <token>"
}
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sayvy.ai/api/v1/agents"))
.header("Authorization", "Bearer <token>")
.GET()
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X GET "https://api.sayvy.ai/api/v1/agents" \
-H "Authorization: Bearer <token>"
{
"agents": [
{
"id": "agent_12345",
"name": "Sales Assistant",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2024-05-20T10:15:30Z",
"updated_at": "2024-05-22T14:22:10Z"
},
{
"id": "e4b2d184-7cf1-4560-a292-6284649bcf2e",
"name": "Support Concierge",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2026-09-03T12:00:00Z",
"updated_at": "2026-09-03T12:00:00Z"
}
]
}
{
"error": 401,
"message": "Unauthorized"
}
Returns a paginated list of all voice agents provisioned within the authenticated organization, including active prompts, voice configurations, and telephony bindings.
Authentication
This endpoint requires Bearer token authentication.Authorization: Bearer <token>
Input parameters
string
required
Bearer token for authentication. Format:
Bearer <token>.Response Fields
AgentResponse[]
import requests
url = "https://api.sayvy.ai/api/v1/agents"
headers = {
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.sayvy.ai/api/v1/agents", {
method: "GET",
headers: {
"Authorization": "Bearer <token>"
}
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sayvy.ai/api/v1/agents"))
.header("Authorization", "Bearer <token>")
.GET()
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X GET "https://api.sayvy.ai/api/v1/agents" \
-H "Authorization: Bearer <token>"
{
"agents": [
{
"id": "agent_12345",
"name": "Sales Assistant",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2024-05-20T10:15:30Z",
"updated_at": "2024-05-22T14:22:10Z"
},
{
"id": "e4b2d184-7cf1-4560-a292-6284649bcf2e",
"name": "Support Concierge",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2026-09-03T12:00:00Z",
"updated_at": "2026-09-03T12:00:00Z"
}
]
}
{
"error": 401,
"message": "Unauthorized"
}
‹ PreviousNext ›
Update agent
Update complete configuration and parameters
Was this page helpful?