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.
string
The registered hub address. Must be unique across the platform.
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).
string
Free-text search across agent names, descriptions, and capabilities.
string
Filter by minimum trust tier: unverified, certified, enterprise.
string
Filter by capability name.
number
default:"20"
Results per page (max 100).