Skip to main content
GET
List Agents

Authorizations

Authorization
string
header
required

The access_token returned by POST /apikeys/token for an API key's secret.

Query Parameters

page
integer
default:1

Page number, starting from 1

Required range: x >= 1
page_size
integer
default:20

Number of items per page

Required range: 1 <= x <= 100
search
string | null

Search by title or description

agent_type
string | null

Filter by agent type: 'agent', 'subagent', or None for all

tags
string | null

Comma-separated tag values to filter by (OR logic)

favourites_only
boolean
default:false

Return only agents favourited by the current user

published_only
boolean
default:false

Leave out agents that were never published

sort_by
string | null

Field to sort by (title, description, model, createdByEmail, knowledgeBases, tools, version, createdAt)

sort_order
string
default:desc

Sort order: asc or desc

Response

Successful Response

Paginated agents list response

items
AgentEntry · object[]
required
meta
PaginationMeta · object
required