---
title: "Set Spend Grant"
method: PUT
path: "/stages/runtime/spend-grant"
tags: ["stages"]
---

# Set Spend Grant

`PUT /stages/runtime/spend-grant`

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

The player allows this stage to spend up to cap_credits of their credits (0 revokes).

## Request body

- StageSpendGrantWrite: Sets how many credits this stage may spend for the player; 0 revokes consent.
  - `install_id` string, uuid, required
  - `character_id` string, uuid, required
  - `chat_session_id` string, uuid, nullable
  - `cap_credits` integer, required

## Response `200`

Successful Response

- 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

## 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/spend-grant/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)