---
title: "Save Runtime State"
method: PUT
path: "/stages/runtime/state"
tags: ["stages"]
---

# Save Runtime State

`PUT /stages/runtime/state`

## 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/state`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

## Request body

- StageStateWrite: Upsert one install's state for a chat. Omitted fields are left unchanged.
  - `chat_session_id` string, uuid, required
  - `install_id` string, uuid, required
  - `init_state` unknown
  - `chat_state` unknown
  - `message_states` StageMessageStateWrite[]
    - `message_id` string, uuid, required
    - `state` unknown
    - `stage_directions` string, nullable

## Response `204`

Successful Response

## 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/state/put.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)