Skip to main content
GET
List agents
This is an internal/undocumented endpoint. It is not part of the public API and may change without notice. Do not rely on this endpoint for production connections.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Query Parameters

name
string

Filter agents by name (case-insensitive substring match).

agent_type
enum<string>[]

Filter agents by one or more agent types.

Required array length: 1 - 100 elements

One of: notion_ai, custom_agent, autofill_custom_agent, external

Available options:
notion_ai,
custom_agent,
autofill_custom_agent,
external
agent_ids
(string | enum<string>)[]

Filter agents by one or more agent IDs. Use notion_ai for Notion Agent (personal agent).

Required array length: 1 - 100 elements
created_by
string[]

Filter agents by one or more creator IDs. Use "me" for the user associated with the API token.

Required array length: 1 - 100 elements
start_cursor
string

If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.

page_size
integer

The number of items from the full list desired in the response. Maximum: 100

Required range: 1 <= x <= 100
verbose
boolean

Whether to include inline instructions for each agent. Defaults to false.

Response

object
string
required

Always list

Allowed value: "list"
type
string
required

Always agent

Allowed value: "agent"
results
object[]
required
Maximum array length: 100
has_more
boolean
required
next_cursor
string | null
required