List agents

Retrieve all Voice AI agents belonging to your organization

GET /api/v1/agents

Python

import requests

url = "https://api.sayvy.ai/api/v1/agents"

headers = {
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)
print(response.json())

200 OK

{
  "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"
    }
  ]
}

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

Authorization · string · required

Bearer token for authentication. Format: Bearer <token>.

---

Response Fields

agents · AgentResponse[]

Array of agent summary objects:

Show Agent item attributes

id · string

Agent UUID.

name · string

Agent display name.

agent_type · string

prompt or static.

is_active · string

active or inactive.

created_at · string

Creation timestamp.

---

Python

import requests

url = "https://api.sayvy.ai/api/v1/agents"

headers = {
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)
print(response.json())

200 OK

{
  "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"
    }
  ]
}

---

‹ Previous

Update agent

Update complete configuration and parameters

Next ›