Skip to main content
GET
List AI agents
Filter kind to chat or voice. Use the returned opaque cursor without changing filters.

Authorizations

Authorization
string
header
required

An API key (tars_sk_…) sent as Authorization: Bearer <key>. Each operation names the permission it needs. Create keys in Settings → Integrations → API keys.

Query Parameters

kind
enum<string>

Only chat agents or only voice agents.

Available options:
chat,
voice
limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string

The nextCursor of the previous page.

Maximum string length: 1024

Response

One page of results.

One page of a list.

items
object[]
required
nextCursor
string | null
required

Pass it as cursor to read the next page.

hasMore
boolean
required