latestOpenAPI 3.1.02026-08-21615231.2 MB

dee5763763b0

Agents

Query agents

post/v1/agents/query

Notion-Version'2026-03-11' required

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

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.

object'list' required

Always list

type'agent' required

Always agent

has_moreboolean required

next_cursorstring nullable required

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