---
title: "POST /registry/agents"
method: POST
path: "/registry/agents"
---

# POST /registry/agents

`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

- object: Request body for registering an agent in the registry
  - `agentId` string, required: ID of the agent to register in the directory
  - `name` string, required: Display name for the registry listing
  - `description` string: Human-readable description of the agent's purpose
  - `tags` string[]: Searchable tags for categorization
  - `public` boolean: Whether this listing is publicly discoverable

## Response `200`

OK

- object: Full registry entry representation
  - `id` string, required: Unique identifier of the registry entry
  - `did` string, required: Decentralized identifier of the agent
  - `agentId` string, required: ID of the registered agent
  - `orgId` string, required: Organization that owns the agent
  - `public` boolean, required: Whether the listing is publicly visible
  - `name` string, required: Display name
  - `description` string, nullable, 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, nullable, 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

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)