---
title: "Get Session By Id"
method: GET
path: "/studio/sessions/{session_id}"
tags: ["AI_STUDIO"]
---

# Get Session By Id

`GET /studio/sessions/{session_id}`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/studio/sessions/{session_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Get a specific AI playground session by ID with its turns

## Path parameters

- `session_id` string, required

## Query parameters

- `navigationSource` string, nullable

## Response `200`

Successful Response

- SessionResponse
  - `session` Session, required
    - `session_id` string, required
    - `name` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `knowledge` string[], nullable
    - `datamates` integer[], nullable
    - `status` 'failed' | 'completed' | 'pending' | 'cancelled'
    - `session_intent` string, nullable
    - `starred_at` string, date-time, nullable
    - `run_status` 'running' | 'succeeded' | 'failed', required: Outcome of a session's *latest* turn, surfaced to the sidebar UI. Distinct from ``status`` (last-turn ``SessionStatusEnum``) and from the lifecycle ``SessionLifecycleStatus`` — this is a coarse three-state view the frontend maps to a spinner (running) / green dot (succeeded) / red dot (failed). Derived at read time from the last turn; see ``AIPlaygroundRepository.derive_run_status``.
    - `has_scheduled_report` boolean, required
    - `scheduled_report_rule_id` integer, nullable
  - `turns` ChatBlock[], required
    - `id` integer, required
    - `role` 'user' | 'assistant' | 'system', required
    - `timestamp` string, date-time, required
    - `content` Content[], required
      - `id` integer, required
      - `type` 'tool_result' | 'write' | 'custom' | 'bash' | 'read' | 'tool_use' | 'tool_call' | 'agent_outcome' | 'text' | 'error' | 'opportunity_draft' | 'ask_user_question', required
      - `content` union
        - string
        - object
      - `timestamp` string, date-time, required
      - `error_type` string, nullable
      - `finding` object, nullable
      - `error_code` string, nullable
    - `attachments` Attachment[]
      - `id` string, required
      - `attachment_name` string, required
      - `file_type` string, nullable
      - `s3_url` string, nullable
      - `extracted_content` string, nullable
      - `order` integer, required
      - `attachment_type` string, required
      - `attachment_reference_id` string, nullable
      - `file_size` integer, nullable
      - `created_on` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-30** `77a7dface13f`: 1 info
  - added the optional property `session/starred_at` to the response with the `200` status
- **2026-10-27** `883849803623`: 1 warning
  - added the new `ask_user_question` enum value to the `turns/items/content/items/type` response property for the response status `200`
- **2026-08-19** `6aa0788aa5dc`: 3 info
  - added the optional property `session/scheduled_report_rule_id` to the response with the `200` status
  - added the required property `session/has_scheduled_report` to the response with the `200` status
  - added the required property `session/run_status` to the response with the `200` status

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/studio/sessions/:session_id/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)