List agent entities, cursor-paginated.

Retrieve a page of agent entities. Unlike the deprecated GET /v1/agents, this endpoint paginates by opaque cursor and honors per-agent sharing, returning only agents the caller is authorized to see.

page_sizeinteger

Number of agents per page

deployment_chatboolean nullable

sourcesRequestSource[] nullable

namestring nullable

Filter by agent name

searchstring nullable

Search agents by name or ID

idstring nullable

page_tokenstring nullable

Opaque cursor from a previous response's next_page_token. When set, results page forward from the cursor.

Response

Successful Response

object'list'

next_page_tokenstring nullable

Example response

{
  "data": [
    {
      "completion_args": {
        "response_format": {
          "type": "text"
        }
      }
    }
  ]
}

v2

List agent entities, cursor-paginated.

Query parameters

Response

Example response