List agents

Returns a list of your agents and their metadata.

page_sizeintegerOptional1-100Defaults to 30

How many Agents to return at maximum. Can not exceed 100, defaults to 30.

searchstring or nullOptional

Search by agents name.

archivedboolean or nullOptionalDefaults to false

Filter agents by archived status

sort_directionenumOptional

The direction to sort the results

Allowed values:

sort_byenumOptional

The field to sort the results by

Allowed values:

cursorstring or nullOptional

Used for fetching next page. Cursor is returned in the response.

Successful Response

agentslist of objects

A list of agents and their metadata

has_moreboolean

Whether there are more agents to paginate through

next_cursorstring or null

The next cursor to paginate through the agents

1	{
2	"agents": [
3	{
4	"agent_id": "J3Pbu5gP6NNKBscdCdwB",
5	"name": "My Agent",
6	"tags": [
7	"Customer Support",
8	"Technical Help",
9	"Eleven"
10	],
11	"created_at_unix_secs": 1716153600,
12	"access_info": {
13	"is_creator": true,
14	"creator_name": "John Doe",
15	"creator_email": "john@example.com",
16	"role": "admin"
17	},
18	"archived": false
19	}
20	],
21	"has_more": false,
22	"next_cursor": "123"
23	}

1	curl https://api.elevenlabs.io/v1/convai/agents \
2	-H "xi-api-key: xi-api-key"