> ## Documentation Index > Fetch the complete documentation index at: https://developers.notion.com/llms.txt > Use this file to discover all available pages before exploring further. # Query session events > Retrieve a page of events from an accessible session. Tool calls identify their tool and lifecycle status, without tool inputs or outputs. ## OpenAPI ````yaml post /v1/sessions/{session_id}/events/query openapi: 3.1.0 info: title: Notion API version: 1.0.0 termsOfService: >- https://notion.notion.site/Terms-and-Privacy-28ffdd083dc3473e9c2da6ec011b58ac servers: - url: https://api.notion.com security: - bearerAuth: [] tags: - name: Databases description: Database endpoints - name: Data sources description: Data source endpoints - name: Pages description: Page endpoints - name: Async tasks description: Async task endpoints - name: Blocks description: Block endpoints - name: Comments description: Comment endpoints - name: File uploads description: File upload endpoints - name: OAuth description: OAuth endpoints (basic authentication) - name: Users description: User endpoints - name: Search description: Search endpoints - name: Views description: View endpoints - name: Agents description: Agent endpoints - name: Sessions description: Session endpoints - name: Custom emojis description: Custom emoji endpoints - name: Meeting notes description: Meeting notes endpoints paths: /v1/sessions/{session_id}/events/query: post: tags: - Sessions summary: Query session events operationId: query-session-events parameters: - name: session_id in: path required: true schema: $ref: '#/components/schemas/idRequest' description: The ID of the session whose events should be queried. - $ref: '#/components/parameters/notionVersion' requestBody: required: true content: application/json: schema: type: object properties: filter: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - and additionalProperties: false properties: and: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - and additionalProperties: false properties: and: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - and additionalProperties: false properties: and: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - or additionalProperties: false properties: or: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - or additionalProperties: false properties: or: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - and additionalProperties: false properties: and: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - or additionalProperties: false properties: or: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - or additionalProperties: false properties: or: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - and additionalProperties: false properties: and: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - and additionalProperties: false properties: and: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - or additionalProperties: false properties: or: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - or additionalProperties: false properties: or: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - and additionalProperties: false properties: and: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time - type: object required: - or additionalProperties: false properties: or: type: array items: oneOf: - type: object required: - property - string additionalProperties: false properties: property: type: string enum: - id string: type: object properties: equals: type: string required: - equals additionalProperties: false - type: object required: - property - event_type additionalProperties: false properties: property: type: string enum: - type event_type: type: object additionalProperties: false properties: equals: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status in: type: array items: type: string enum: - user.message - agent.message - agent.thinking - agent.tool_use - agent.tool_result - session.status - type: object required: - property - number additionalProperties: false properties: property: type: string enum: - sequence number: type: object additionalProperties: false properties: greater_than: type: number greater_than_or_equal_to: type: number less_than: type: number less_than_or_equal_to: type: number - type: object required: - property - timestamp additionalProperties: false properties: property: type: string enum: - created_at timestamp: type: object additionalProperties: false properties: equals: type: string format: date-time before: type: string format: date-time after: type: string format: date-time on_or_before: type: string format: date-time on_or_after: type: string format: date-time description: >- A session event property filter, or an and/or compound filter nested up to three levels deep. sorts: type: array items: type: object properties: property: type: string enum: - sequence - created_at description: 'One of: `sequence`, `created_at`' direction: type: string enum: - ascending - descending description: 'One of: `ascending`, `descending`' additionalProperties: false required: - property - direction maxItems: 2 minItems: 1 description: Ordered sort precedence. Defaults to sequence ascending. start_cursor: type: string description: The continuation cursor returned by the previous page. page_size: type: integer minimum: 1 maximum: 100 description: 'The number of events to return. Maximum: 100.' additionalProperties: false responses: '200': description: '' content: application/json: schema: type: object properties: object: type: string const: list description: Always `list` type: type: string const: session_event description: Always `session_event` session_event: type: object properties: {} additionalProperties: false results: type: array items: oneOf: - type: object properties: object: type: string const: session_event description: Always `session_event` id: type: string session_id: type: string sequence: type: integer minimum: 1 created_at: type: string type: type: string const: user.message description: Always `user.message` content: type: array items: oneOf: - type: object properties: type: type: string const: text description: Always `text` text: type: string additionalProperties: false required: - type - text - type: object properties: type: type: string const: file description: Always `file` name: type: string content_type: type: string url: type: string expiry_time: type: string additionalProperties: false required: - type - name - content_type - url created_by: oneOf: - type: object properties: id: type: string type: type: string enum: - user - bot description: 'One of: `user`, `bot`' additionalProperties: false required: - id - type - type: 'null' metadata: oneOf: - type: object additionalProperties: type: string maxLength: 2000 - type: 'null' additionalProperties: false required: - object - id - session_id - sequence - created_at - type - content - created_by - metadata - type: object properties: object: type: string const: session_event description: Always `session_event` id: type: string session_id: type: string sequence: type: integer minimum: 1 created_at: type: string type: type: string const: agent.message description: Always `agent.message` content: type: array items: oneOf: - type: object properties: type: type: string const: text description: Always `text` text: type: string additionalProperties: false required: - type - text - type: object properties: type: type: string const: file description: Always `file` name: type: string content_type: type: string url: type: string expiry_time: type: string additionalProperties: false required: - type - name - content_type - url created_by: oneOf: - type: object properties: id: type: string type: type: string enum: - user - bot description: 'One of: `user`, `bot`' additionalProperties: false required: - id - type - type: 'null' metadata: oneOf: - type: object properties: model: type: string additionalProperties: false required: - model - type: 'null' additionalProperties: false required: - object - id - session_id - sequence - created_at - type - content - created_by - metadata - type: object properties: object: type: string const: session_event description: Always `session_event` id: type: string session_id: type: string sequence: type: integer minimum: 1 created_at: type: string type: type: string const: agent.thinking description: Always `agent.thinking` content: type: array items: type: object properties: type: type: string const: text description: Always `text` text: type: string additionalProperties: false required: - type - text additionalProperties: false required: - object - id - session_id - sequence - created_at - type - content - type: object properties: object: type: string const: session_event description: Always `session_event` id: type: string session_id: type: string sequence: type: integer minimum: 1 created_at: type: string type: type: string const: agent.tool_use description: Always `agent.tool_use` tool_name: type: string additionalProperties: false required: - object - id - session_id - sequence - created_at - type - tool_name - type: object properties: object: type: string const: session_event description: Always `session_event` id: type: string session_id: type: string sequence: type: integer minimum: 1 created_at: type: string type: type: string const: agent.tool_result description: Always `agent.tool_result` tool_use_id: type: string tool_name: type: string is_error: type: boolean additionalProperties: false required: - object - id - session_id - sequence - created_at - type - tool_use_id - tool_name - is_error - type: object properties: object: type: string const: session_event description: Always `session_event` id: type: string session_id: type: string sequence: type: integer minimum: 1 created_at: type: string type: type: string const: session.status description: Always `session.status` status: type: string enum: - requires_action - completed - failed - canceled - terminated description: >- One of: `requires_action`, `completed`, `failed`, `canceled`, `terminated` required_actions: type: array items: type: object properties: action_id: type: string title: type: string options: type: array items: type: object properties: id: type: string enum: - approve - reject description: 'One of: `approve`, `reject`' label: type: string additionalProperties: false required: - id - label maxItems: 100 additionalProperties: false required: - action_id - title - options error: type: object properties: code: type: string message: type: string retryable: type: boolean additionalProperties: false required: - code - message - retryable additionalProperties: false required: - object - id - session_id - sequence - created_at - type - status maxItems: 100 has_more: type: boolean next_cursor: oneOf: - title: Cursor type: string - type: 'null' additionalProperties: false required: - object - type - session_event - results - has_more - next_cursor '400': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_400' '401': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_401' '403': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_403' '404': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_404' '406': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_406' '409': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_409' '429': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_429' '500': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_500' '503': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_503' '504': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_504' '529': description: '' content: application/json: schema: $ref: '#/components/schemas/error_api_529' x-codeSamples: - lang: javascript label: TypeScript SDK source: |- import { Client } from "@notionhq/client" const notion = new Client({ auth: process.env.NOTION_API_KEY }) const response = await notion.sessions.queryEvents({ session_id: "2a1c7c06-781b-4987-9986-5c8dd3028014", filter: { property: "type", event_type: { equals: "agent.message" } } }) components: schemas: idRequest: type: string error_api_400: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - invalid_json - invalid_request_url - invalid_request - missing_version - invalid_beta - validation_error - invalid_credit_limit status: const: 400 required: - code - status additionalProperties: false error_api_401: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - unauthorized status: const: 401 required: - code - status additionalProperties: false error_api_403: oneOf: - allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - restricted_resource - status_change_not_allowed status: const: 403 required: - code - status additionalProperties: false - allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: const: workspace_credits_exhausted status: const: 403 additional_data: type: object properties: tool_error_code: const: workspace_credits_exhausted tool_error_class: const: entitlement_required tool_error_retryable: const: 'false' recovery_kind: enum: - contact_workspace_owner - open_workspace_credit_settings description: The recovery action selected by Notion for the caller. recovery_url: type: string format: uri description: >- Present when recovery_kind directs the caller to a settings page. required: - tool_error_code - tool_error_class - tool_error_retryable - recovery_kind additionalProperties: oneOf: - type: string - type: array items: type: string required: - code - status - additional_data - allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: const: agent_credit_limit_reached status: const: 403 additional_data: type: object properties: tool_error_code: const: agent_credit_limit_reached tool_error_class: const: entitlement_required tool_error_retryable: const: 'false' recovery_kind: enum: - contact_workspace_owner - none - open_agent_settings - request_agent_limit_increase - request_pending description: The recovery action selected by Notion for the caller. recovery_url: type: string format: uri description: >- Present when recovery_kind directs the caller to a settings page. required: - tool_error_code - tool_error_class - tool_error_retryable - recovery_kind additionalProperties: oneOf: - type: string - type: array items: type: string required: - code - status - additional_data error_api_404: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - object_not_found - directory_not_found status: const: 404 required: - code - status additionalProperties: false error_api_406: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - row_limit_exceeded status: const: 406 required: - code - status additionalProperties: false error_api_409: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - conflict_error - idempotency_key_reused - agent_deleted status: const: 409 required: - code - status additionalProperties: false error_api_429: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - rate_limited status: const: 429 required: - code - status additionalProperties: false error_api_500: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - internal_server_error status: const: 500 required: - code - status additionalProperties: false error_api_503: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - service_unavailable status: const: 503 required: - code - status additionalProperties: false error_api_504: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - gateway_timeout status: const: 504 required: - code - status additionalProperties: false error_api_529: allOf: - $ref: '#/components/schemas/publicApiCommonErrorResponse' - type: object properties: code: enum: - service_overload status: const: 529 required: - code - status additionalProperties: false publicApiCommonErrorResponse: type: object properties: object: const: error message: type: string additional_data: type: object additionalProperties: oneOf: - type: string - type: array items: type: string required: - object - message parameters: notionVersion: name: Notion-Version in: header required: true schema: enum: - '2026-03-11' description: >- The [API version](/reference/versioning) to use for this request. The latest version is `2026-03-11`. securitySchemes: bearerAuth: type: http scheme: bearer ````