---
title: "Get session"
method: GET
path: "/api/sessions/{session_id}"
tags: ["sessions"]
---

# Get session

`GET /api/sessions/{session_id}`

Get a session by ID.

## Path parameters

- `session_id` string, uuid, required

## Response `200`

Successful Response

- Session — Web UI session metadata.
  - `session_id` string, uuid, required — Session unique ID
  - `title` string, required — Session title derived from kimi-cli history
  - `last_updated` string, date-time, required — Last updated timestamp
  - `is_running` boolean — Whether the session is running
  - `status` SessionStatus — Runtime status of a web session.
    - `session_id` string, uuid, required — Session unique ID
    - `state` 'stopped' | 'idle' | 'busy' | 'restarting' | 'error', required — Current session state
    - `seq` integer, required — Monotonic sequence number
    - `worker_id` string, nullable — Worker instance ID
    - `reason` string, nullable — Reason for the state transition
    - `detail` string, nullable — Additional detail for debugging
    - `updated_at` string, date-time, required — Timestamp for this state
  - `work_dir` string, nullable — Working directory for the session
  - `session_dir` string, nullable — Session directory path
  - `archived` boolean — Whether the session is archived

## Other responses

- `422` — Validation Error

## Changes

> 3 revisions in range; 1 could not be searched.

- **2026-01-29** `c455806f620b` — 1 warning
  - removed the optional property `anyOf[subschema #1: Session]/archived` from the response with the `200` status

[Change history](https://skmtc.dev/moonshotai/apis/kimi-code-cli-web-interface/changes/api/sessions/:session_id/get.md)

---

[API](https://skmtc.dev/moonshotai/apis/kimi-code-cli-web-interface.md) · [All operations](https://skmtc.dev/moonshotai/apis/kimi-code-cli-web-interface/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moonshotai/kimi-code-cli-web-interface/revisions/8eac348b2e66/schema)