---
title: "List Plan Mode Sessions"
method: GET
path: "/agents/planner/plan-mode-sessions"
tags: ["PlanModeSessions"]
---

# List Plan Mode Sessions

`GET /agents/planner/plan-mode-sessions`

Returns plan mode sessions for the current user company. Each row includes the linked chat session id and the parent scenario dimension (DimensionSerializer shape; plan-mode scenario dimensions do not include list-only formula rollup fields).

## Headers

- `X-Company-ID` string, required

## Response `200`

Plan mode sessions for the current user company

- PlanModeSessionList[]
  - `id` integer, required
  - `chat_session` string, required
  - `created_at` string, date-time, required
  - `parent_scenario` object, required
  - `headline_metrics_canvas` string, uuid, nullable, required
  - `updates_canvas` string, uuid, nullable, required
  - `recommendations` PlanModeRecommendation[], required
    - `id` integer, required
    - `recommendation_type` 'RISK' | 'OPPORTUNITY' | 'DATA_GAP' | 'INFO', required — * `RISK` - Risk * `OPPORTUNITY` - Opportunity * `DATA_GAP` - Data gap * `INFO` - Info
    - `description` string, required
    - `action_label` string, required
    - `created_at` string, date-time, required
  - `key_assumptions` PlanModeKeyAssumption[], required
    - `id` integer, required
    - `name` string, required
    - `value` string, required
    - `source` 'USER' | 'AI', required — * `USER` - User * `AI` - AI
    - `display_order` integer, required
    - `created_at` string, date-time, required

---

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