v11

latestOpenAPI 3.0.0raw.githubusercontent.com2026-01-29273578.1 KB
Agents

Update Agent

Update an existing agent. If a new iconUrl is provided, the server will fetch the icon from the external URL, upload it to R2 storage, and delete the old icon. The response will contain the new R2 URL.

put/api/v1/agents/{id}

Path parameters

idstring required

The unique identifier

Example:12345

Request body

scopestring
slugstring
displayNamestring
descriptionstring
iconUrlstring uri
authorstring
categorystring
tagsstring[]

Example request

{
  "agent": {
    "platform": "agent0",
    "url": "https://agent0.example.com/agents/abc123"
  }
}

Response

Agent updated successfully

Example response

{
  "agent": {
    "agent": {
      "platform": "agent0",
      "url": "https://agent0.example.com/agents/abc123"
    }
  }
}