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"
    }
  }
}

Changes

Changed in 3 of the 11 revisions of this API.334

Jan 21, 2026ba253fbf08a72See the full diff
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the optional property agent/developerId to the response with the 200 status
  response-optional-property-added
Jan 18, 2026b0e6563d3fce331See the full diff
- ▲
  the code response property const value INTERNAL_SERVER_ERROR was removed for the status 500
  response-property-const-removed
- ▲
  the code response property const value NOT_FOUND was removed for the status 404
  response-property-const-removed
- ▲
  the code response property const value UNAUTHORIZED was removed for the status 401
  response-property-const-removed
- ●
  added the new INTERNAL_SERVER_ERROR enum value to the code response property for the response status 500
  response-property-enum-value-added
- ●
  added the new NOT_FOUND enum value to the code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new UNAUTHORIZED enum value to the code response property for the response status 401
  response-property-enum-value-added
- ○
  api operation id putApiV1AgentsById removed and replaced with
  api-operation-id-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 17, 20264f3d96fe26561See the full diff
- ○
  endpoint added
  endpoint-added

Full history