Skip to main content
GET
Search the agent registry (paginated discovery)

Authorizations

Authorization
string
header
required

API key (pk_test_* or pk_live_), JWT session, agent token (agent_), Ed25519 session (sess_), or portal token (portal_).

Query Parameters

q
string

Free-text over agent name/description and registered-skill id/name

tag
string

Comma-separated registered-skill tags; match if any skill overlaps

skill
string

Alias for tag — a skill tag to filter by

tier
integer | null

Exact KYA tier filter

Required range: 0 <= x <= 3
status
string

Agent status (default 'active'; pass 'any' to include all)

scope
enum<string>

Discovery scope (default 'all')

Available options:
all,
mine
page
integer
default:1
limit
integer
default:50
Required range: x <= 200

Response

200 - application/json

Paginated discoverable agents

data
object[]
required
pagination
object
required