Skip to main content
GET
/
h
/
v2
/
agents
List agents
curl --request GET \
  --url https://api.openmic.ai/h/v2/agents \
  --header 'Authorization: Bearer <token>'
{
  "agents": [
    {
      "uid": "agent_abc123",
      "name": "Sales Agent",
      "prompt": "You are a helpful sales agent...",
      "voice_provider": "ElevenLabs",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "has_more": false
}

Authorizations

​
Authorization
string
header
required

API key obtained from the OpenMic dashboard.

Query Parameters

​
page_size
integer

Number of records per page (default 50, max 100).

Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor returned by the previous response.

​
name
string

Case-insensitive partial match on the agent name.

​
created_after
string<date-time>

Filter records created on or after this ISO 8601 timestamp.

​
created_before
string<date-time>

Filter records created on or before this ISO 8601 timestamp.

Response

Paginated list of agents.

​
has_more
boolean
required

Whether more records exist after this page.

​
agents
object[]
required
​
next_cursor
string

Opaque cursor to pass as cursor in the next request.