---
title: "Get session by workspace"
method: GET
path: "/v1/sessions/workspace/{workspace}"
tags: ["sessions"]
---

# Get session by workspace

`GET /v1/sessions/workspace/{workspace}`

Returns session information for a specific workspace. Accepts workspace ID (UUID) or path. Use ?full=true for complete session data including messages. Supports conditional requests via If-None-Match header for efficient polling.

## Path parameters

- `workspace` string, required

## Query parameters

- `full` boolean

## Headers

- `If-None-Match` string

## Response `200`

Basic session info when full=false

- InternalHandlersActiveSessionInfo — Active session information with timing and Claude session details
  - `claude_session_uuid` string — Unique identifier for the Claude session
  - `ended_at` string — When the session ended (if not active)
  - `resumed_at` string — When the session was resumed (if applicable)
  - `started_at` string — When the session was initially started
  - `title` string — Title of the session

## Other responses

- `304` — Not Modified - content unchanged

## Changes

- **2025-12-03** `648598c377f9` — 2 info
  - added the new optional `header` request parameter `If-None-Match`
  - added the non-success response with the status `304`
- **2025-07-18** `21270d5158bd` — 1 warning, 1 info
  - deleted the `header` request parameter `If-None-Match`
  - removed the non-success response with the status `304`

[Change history](https://skmtc.dev/wandb/apis/catnip-container-api/changes/v1/sessions/workspace/:workspace/get.md)

---

[API](https://skmtc.dev/wandb/apis/catnip-container-api.md) · [All operations](https://skmtc.dev/wandb/apis/catnip-container-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wandb/catnip-container-api/revisions/a075b0fa501a/schema)