---
title: "Update Overage Setting"
method: PUT
path: "/api/v1/billing/settings/overage"
tags: ["Billing"]
---

# Update Overage Setting

`PUT /api/v1/billing/settings/overage`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.mor.org/oauth2/authorize`
    - Token URL: `https://auth.mor.org/oauth2/token` scopes: `aws.cognito.signin.user.admin`, `openid`, `email`, `profile`
  - HTTP bearer

Toggle the "Allow Overages" setting for the authenticated user.

When **enabled** (`allow_overage: true`):
- If your Daily Staking Allowance is exhausted, the system automatically
  deducts from your paid Credit Balance to prevent service interruption.

When **disabled** (`allow_overage: false`, default):
- Requests will fail with an `insufficient_balance` error once your
  Daily Staking Allowance is depleted. Your paid Credit Balance is not touched.

## Request body

- OverageSettingsRequest: Request for PUT /billing/settings/overage.
  - `allow_overage` boolean, required: When enabled, the system automatically uses your paid Credit Balance after the Daily Staking Allowance is exhausted. When disabled, requests will fail once staking credits are depleted.

## Response `200`

Successful Response

- OverageSettingsResponse: Response for overage settings update.
  - `allow_overage` boolean, required
  - `message` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/billing/settings/overage/put.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)