---
title: "List Installs"
method: GET
path: "/stages/installs"
tags: ["stages"]
---

# List Installs

`GET /stages/installs`

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

## Query parameters

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

## Response `200`

Successful Response

- StageInstallDetail[]
  - `id` string, uuid, required
  - `version_id` string, uuid, required
  - `character_id` string, uuid, nullable
  - `chat_session_id` string, uuid, nullable
  - `installed_by` string, uuid, nullable
  - `config` object, required
  - `enabled` boolean, required
  - `position` integer, required
  - `created_at` string, date-time, required
  - `project_id` string, uuid, required
  - `project_name` string, required
  - `tagline` string, nullable
  - `version` string, required
  - `stage_position` 'side' | 'cover' | 'fullscreen' | 'none', required
  - `capabilities` string[]
  - `config_schema` object, nullable
  - `latest_version_id` string, uuid, nullable
  - `latest_version` string, nullable

## Other responses

- `422`: Validation Error

## Changes

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

[Operation history](https://skmtc.dev/meganova/apis/fastapi/changes/stages/installs/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)
