Sign in
Agents

List Agents

Retrieve paginated list of agents with cursor-based pagination

get/api/v1/agents

Query parameters

limitinteger

Max agents per page (max: 100, default: 12)

cursorstring

Pagination cursor from previous response

Example:eyJzb3J0RmllbGQiOiJ1cGRhdGVkQXQiLCJzb3J0VmFsdWUiOiIyMDI1LTAxLTAxVDEyOjAwOjAwWiIsImxhc3RJZCI6IjEyMzQ1In0=
sortstring

Sort by 'displayName' or 'updatedAt' (default)

Example:updatedAt
searchstring

Filter by name or description

Example:assistant

Response

Successful response with list of agents

nextstring
totalCountnumber required

Example response

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

Changes

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

  • ba253fbf08a71See the full diff
    • ○

      added the optional property agents/items/developerId to the response with the 200 status

      response-optional-property-added

  • b0e6563d3fce111See the full diff
    • ▲

      the code response property const value INTERNAL_SERVER_ERROR was removed for the status 500

      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

    • ○

      api operation id getApiV1Agents 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

  • 4f3d96fe26561See the full diff
    • ○

      endpoint added

      endpoint-added