Chat with agent
Internal Endpoints
Chat with Agent
POST
Chat with agent
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Path Parameters
The ID of the agent to chat with. Use a UUID for custom agents, or 33333333-3333-3333-3333-333333333333 for the personal agent (Notion AI).
Body
application/json
The message to send to the agent.
Maximum string length:
10000The ID of an existing thread to continue the conversation. If not provided, a new thread will be created.
An array of file uploads to attach to this chat turn. Use the File Upload APIs to create uploads and pass their IDs here.
Maximum array length:
100