Skip to main content
GET
/
v1
/
agents
/
{agent_id}
Get Agent
curl --request GET \
  --url https://api.agenthuman.com/v1/agents/{agent_id} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "agent": {
    "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"
    }
  }
}

Path Parameters

agent_id
string
required
The unique agent identifier (starts with agnt_).

Response

success
boolean
Whether the request was successful.
agent
object
The Agent object.
{
  "success": true,
  "agent": {
    "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"
    }
  }
}