---
title: "Cancel a session"
method: POST
path: "/v1/sessions/{session_id}/cancel"
tags: ["Sessions"]
---

# Cancel a session

`POST /v1/sessions/{session_id}/cancel`

## Path parameters

- `session_id` string, required

## Headers

- `Notion-Version` '2026-03-11', required

## Request body

- object
  - `event_id` string — A session event identifying the turn to cancel. If omitted, cancels the current nonterminal turn.

## Response `200`

- object
  - `object` 'session', required — Always `session`
  - `id` string, required
  - `agent_id` string, required
  - `title` string, required
  - `status` 'queued' | 'in_progress' | 'requires_action' | 'completed' | 'failed' | 'canceled' | 'terminated', required — One of: `queued`, `in_progress`, `requires_action`, `completed`, `failed`, `canceled`, `terminated`
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `required_actions` object[]
    - `action_id` string, required
    - `title` string, required
    - `options` object[], required
      - `id` 'approve' | 'reject', required — One of: `approve`, `reject`
      - `label` string, required
  - `error` object
    - `code` string, required
    - `message` string, required
    - `retryable` boolean, required

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/dee5763763b0/schema)