Skip to main content
GET
/
v1
/
agents
List Agents
curl --request GET \
  --url https://api.agenthuman.com/v1/agents \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "agents": [
    {
      "agent_id": "agnt_01J8ZK4R2N5M6P7Q8W4T",
      "name": "Support Agent",
      "avatar_image_url": "https://cdn.example.com/avatars/support.jpg",
      "created_at": "2024-01-15T10:00:00Z",
      "voice_agent": {
        "provider": "ElevenLabs",
        "agent_id": "el_agent_xxxxxxxxxxxxxxxx",
        "auth_method": "public"
      }
    }
  ]
}

​
Response

​
success
boolean
Whether the request was successful.
​
agents
array
Array of Agent objects belonging to the authenticated user, ordered by created_at descending.
{
  "success": true,
  "agents": [
    {
      "agent_id": "agnt_01J8ZK4R2N5M6P7Q8W4T",
      "name": "Support Agent",
      "avatar_image_url": "https://cdn.example.com/avatars/support.jpg",
      "created_at": "2024-01-15T10:00:00Z",
      "voice_agent": {
        "provider": "ElevenLabs",
        "agent_id": "el_agent_xxxxxxxxxxxxxxxx",
        "auth_method": "public"
      }
    }
  ]
}