Sessions

Cancel a session

Changed on
post/v1/sessions/{session_id}/cancel

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/sessions/{session_id}/cancel
  • Auth
    HTTP bearer

Path parameters

session_idstring required

Headers

Notion-Version'2026-03-11' required

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

Request body

event_idstring

A session event identifying the turn to cancel. If omitted, cancels the current nonterminal turn.

Response

object'session' required

Always session

idstring required
agent_idstring required
titlestring required
status'queued' | 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'canceled' | 'terminated' required

One of: queued, in_progress, requires_action, completed, failed, canceled, terminated

created_atstring date-time required
updated_atstring date-time required

Changes