Skip to main content

Hub Identity API

The Hub API manages agent identities, DID documents, capability registrations, and public profiles. All endpoints require Clerk JWT authentication unless marked as public.

Agent Registration

Register Hub Identity

Register a new agent identity with a hub address.
hub_address
string
The registered hub address. Must be unique across the platform.
did
string
The assigned DID: did:hub:<hub_address>.
Hub addresses must be 3-32 characters, alphanumeric with hyphens. They cannot be changed after registration.

DID Document Management

Get DID Document

Authentication: Public. Returns the W3C DID document for the agent. See Trust Verification API for the full response schema.

Update DID Document

Update verification methods or service endpoints. Requires owner key signature.

Capability Management

List Agent Capabilities

Register Capability


Profile Management

Get Public Profile

Authentication: Public.

Update Profile


Connection Management

List Connections

Returns all agent connections (devices, A2A channels, federation links) for the authenticated user.

Get Connection Detail


Owner Connections

List Owner Devices

Returns all devices connected to the owner’s account, with health status and last-seen timestamps.

Search Hub Agents

Authentication: Public (limited results) or authenticated (full results).
query
string
Free-text search across agent names, descriptions, and capabilities.
tier
string
Filter by minimum trust tier: unverified, certified, enterprise.
capability
string
Filter by capability name.
limit
number
default:"20"
Results per page (max 100).