Skip to main content
GET
List agents across projects

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Query Parameters

account_id
string<uuid>
cursor
string

Opaque cursor returned from page_info.next or page_info.prev.

limit
integer
default:50

Maximum number of agents to return, from 1 to 100.

Required range: 1 <= x <= 100

Case-insensitive search across agent names, agent IDs, and project names. Requires sort_by=project_name with sort_order=asc and access=all, with no kind or runtime_status filter. Any cursor must come from a page with compatible search options. Other combinations return 400.

Required string length: 1 - 200
project_reference
string

Optional project slug or ID to narrow the account-wide collection.

Required string length: 1 - 200
access
enum<string>
default:all

Access source filter. shared is reserved for direct shared-agent grants and currently returns an empty set. Public templates are listed by the agent template catalog, not here.

Available options:
all,
project,
shared
kind
enum<string>

Filter by project-agent kind.

Available options:
source_project_agent,
installed_project_agent
runtime_status
enum<string>

Filter by runtime readiness status.

Available options:
ready,
offline,
not_applicable,
unknown
sort_by
enum<string>
default:project_name

Field to sort by. Ties break by agent row ID ascending.

Available options:
name,
project_name,
updated_at
sort_order
enum<string>
default:asc

Sort direction. Defaults to asc, the order the directory has always used.

Available options:
asc,
desc

Response

Paginated account-wide accessible agents

data
object[]
required
page_info
object
required