---
title: "Get Runtime Session"
method: GET
path: "/stages/runtime/session"
tags: ["stages"]
---

# Get Runtime Session

`GET /stages/runtime/session`

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/stages/runtime/session`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Stages active for a chat, with their saved state. A new chat has no chat_session_id yet.

## Query parameters

- `character_id` string, uuid, required
- `chat_session_id` string, uuid, nullable

## Response `200`

Successful Response

- StageRuntimeSession
  - `chat_session_id` string, uuid, nullable
  - `installs` StageRuntimeInstall[], required
    - `install_id` string, uuid, required
    - `project_id` string, uuid, required
    - `project_name` string, required
    - `scope` 'character' | 'chat', required
    - `version` string, required
    - `bundle_url` string, required
    - `position` 'side' | 'cover' | 'fullscreen' | 'none', required
    - `config` object, required
    - `capabilities` string[]
    - `spend` StageSpend: The current player's consent for one install: how much it may spend, and has spent.
      - `install_id` string, uuid, required
      - `cap_credits` integer, required
      - `spent_credits` integer, required
    - `init_state` unknown
    - `chat_state` unknown
    - `message_states` object
    - `message_directions` object
  - `prices` object

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `c683584f6060`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meganova/apis/fastapi/changes/stages/runtime/session/get.md)

---

[API](https://skmtc.dev/meganova/apis/fastapi.md) - [All operations](https://skmtc.dev/meganova/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/meganova/apis/fastapi/revisions/c683584f6060?raw)