Skip to main content
PUT
/
registry
/
agents
/
{did}
cURL
curl --request PUT \
  --url https://api.useanima.sh/v1/registry/agents/{did} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "tags": [
    "<string>"
  ],
  "public": true
}
'
{
  "id": "<string>",
  "did": "<string>",
  "agentId": "<string>",
  "orgId": "<string>",
  "public": true,
  "name": "<string>",
  "description": "<string>",
  "agentCard": {},
  "trustScore": 123,
  "kyaLevel": "<string>",
  "capabilities": [
    "<string>"
  ],
  "tags": [
    "<string>"
  ],
  "verified": true,
  "verifiedAt": "2023-11-07T05:31:56Z",
  "listedAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization
string
header
required

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

Path Parameters

did
string
required

DID of the agent to update

Body

application/json

Request body for updating a registry entry

name
string

Updated display name

Required string length: 2 - 200
description
string

Updated description

Maximum string length: 2000
tags
string[]

Updated tags

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

Updated visibility

Response

200 - application/json

OK

Full registry entry representation

id
string
required

Unique identifier of the registry entry

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
did
string
required

Decentralized identifier of the agent

agentId
string
required

ID of the registered agent

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
orgId
string
required

Organization that owns the agent

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
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

Trust score (0-100)

kyaLevel
string
required

KYA verification level

capabilities
string[]
required

List of agent capabilities

tags
string[]
required

Searchable tags

verified
boolean
required

Whether the agent has been verified

verifiedAt
string<date-time> | null
required

Timestamp of verification

listedAt
string<date-time>
required

Timestamp when the agent was listed

updatedAt
string<date-time>
required

Timestamp of last update