post/registry/agents

Request

  • Base URL: https://api.useanima.sh/v1
  • URL: https://api.useanima.sh/v1/registry/agents
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

agentIdstring required

ID of the agent to register in the directory

namestring required

Display name for the registry listing

descriptionstring

Human-readable description of the agent's purpose

tagsstring[]

Searchable tags for categorization

publicboolean

Whether this listing is publicly discoverable

Response

OK

idstring required

Unique identifier of the registry entry

didstring required

Decentralized identifier of the agent

agentIdstring required

ID of the registered agent

orgIdstring required

Organization that owns the agent

publicboolean required

Whether the listing is publicly visible

namestring required

Display name

descriptionstring nullable required

Agent description

agentCardobject required

Structured agent card with capabilities and metadata

trustScoreinteger 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.

kyaLevelstring required

KYA verification level (reserved — not yet populated)

capabilitiesstring[] required

List of agent capabilities

tagsstring[] required

Searchable tags

verifiedboolean required

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

verifiedAtstring date-time nullable required

Timestamp of verification (reserved — not yet populated)

listedAtstring date-time required

Timestamp when the agent was listed

updatedAtstring date-time required

Timestamp of last update

Changes

No recorded changes to this operation across all 1 revision of this API.