Agents

Create Agent

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

post/api/v1/agents

Request body

scopestring required

slugstring required

displayNamestring required

descriptionstring required

iconUrlstring uri

authorstring

categorystring

tagsstring[]

Example request

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

Response

Agent created 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.223

Jan 21, 2026ba253fbf08a71See the full diff
- ○
  added the optional property agent/developerId to the response with the 201 status
  response-optional-property-added
Jan 18, 2026b0e6563d3fce221See 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 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 UNAUTHORIZED enum value to the code response property for the response status 401
  response-property-enum-value-added
- ○
  api operation id postApiV1Agents 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