Agents

Query agents

Changed on
post/v1/agents/query

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/agents/query
  • Auth
    HTTP bearer

Headers

Notion-Version'2026-03-11' required

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

Request body

querystring

Search agent names and descriptions using a case-insensitive substring match.

start_cursorstring

Opaque continuation cursor from the previous page.

page_sizeinteger

Number of agents to return. Maximum: 100.

verboseboolean

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

include_deletedboolean

Whether to include soft-deleted agents. Defaults to false.

Response

object'list' required

Always list

type'agent' required

Always agent

has_moreboolean required
next_cursorstring nullable required

Example response

{
  "results": [
    {
      "icon": {
        "emoji": "😀"
      }
    }
  ]
}

Changes

  • 789bd1e5766bRevision changes
    • warning

      added the new owner_allowance_limit enum value to the //// response property for the response status

  • 61fced3986b8Revision changes
    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • info

      removed subschema #1 subschema #2 from the / response property oneOf list for the response status