Skip to main content
GET
List Accessible Agents

Authorizations

Authorization
string
header
required

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

Query Parameters

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, project, provider, skill, and tool metadata.

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.

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
enum<string>
default:+project_name

Sort order. Supported values: +name, -name, +project_name, -project_name, +updated_at, -updated_at.

Available options:
+name,
-name,
+project_name,
-project_name,
+updated_at,
-updated_at

Response

Paginated account-wide accessible agents

data
object[]
required
page_info
object
required

Pagination cursor values for traversing the result set.