Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Body

application/json

Request body for registering an agent in the registry

agentId
string
required

ID of the agent to register in the directory

Pattern: ^[cC][^\s-]{8,}$
name
string
required

Display name for the registry listing

Required string length: 2 - 200
description
string

Human-readable description of the agent's purpose

Maximum string length: 2000
tags
string[]

Searchable tags for categorization

Maximum array length: 20
Maximum string length: 50
public
boolean

Whether this listing is publicly discoverable

Response

200 - application/json

OK

Full registry entry representation

id
string
required

Unique identifier of the registry entry

Pattern: ^[cC][^\s-]{8,}$
did
string
required

Decentralized identifier of the agent

agentId
string
required

ID of the registered agent

Pattern: ^[cC][^\s-]{8,}$
orgId
string
required

Organization that owns the agent

Pattern: ^[cC][^\s-]{8,}$
public
boolean
required

Whether the listing is publicly visible

name
string
required

Display name

description
string | null
required

Agent description

agentCard
object
required

Structured agent card with capabilities and metadata

trustScore
integer
required

Reserved — a fixed placeholder, not a ranking. Not computed from any signal; do not sort, filter, or gate on it. Verify an agent cryptographically instead: resolve its DID document and check the signatures on its verifiable credentials.

kyaLevel
string
required

KYA verification level (reserved — not yet populated)

capabilities
string[]
required

List of agent capabilities

tags
string[]
required

Searchable tags

verified
boolean
required

Whether the agent has been verified (reserved — not yet populated)

verifiedAt
string<date-time> | null
required

Timestamp of verification (reserved — not yet populated)

listedAt
string<date-time>
required

Timestamp when the agent was listed

updatedAt
string<date-time>
required

Timestamp of last update