---
title: "Get session todos"
method: GET
path: "/session/{sessionID}/todo"
---

# Get session todos

`GET /session/{sessionID}/todo`

Retrieve the todo list associated with a specific session, showing tasks and action items.

## Path parameters

- `sessionID` string, required

## Query parameters

- `directory` string
- `workspace` string

## Response `200`

Todo list

- Todo[]
  - `content` string, required — Brief description of the task
  - `status` string, required — Current status of the task: pending, in_progress, completed, cancelled
  - `priority` string, required — Priority level of the task: high, medium, low

## Other responses

- `400` — Bad request
- `404` — Not found

## Changes

- **2026-04-25** `0a2d50cb4204` — 2 breaking, 1 info
  - added the pattern `^ses.*` to the `path` request parameter `sessionID`
  - removed the required property `items/id` from the response with the `200` status
  - added the new optional `query` request parameter `workspace`

[Change history](https://skmtc.dev/kaaass/apis/opencode/changes/session/:sessionID/todo/get.md)

---

[API](https://skmtc.dev/kaaass/apis/opencode.md) · [All operations](https://skmtc.dev/kaaass/apis/opencode/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kaaass/opencode/revisions/8bb9a15bd144/schema)