Sign in
beta.agents

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.

get/v1/agents/pages

Query parameters

page_sizeinteger

Number of agents per page

Number of agents per page

deployment_chatboolean nullable
sourcesRequestSource[] nullable
namestring nullable

Filter by agent name

Filter by agent name

searchstring nullable

Search agents by name or ID

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.

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

Changes

Changed in 1 of the 3 revisions of this API.1