---
title: "Topup"
method: POST
path: "/v1/billing/topup"
tags: ["billing"]
---

# Topup

`POST /v1/billing/topup`

## Request

- Base URL: `https://api.opero.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.opero.pro/v1/billing/topup`
- Auth: none declared

Turn auto top-up on or off, with burn-derived defaults.

`{"supported": false}` when the vendor cannot set the threshold config on
a live contract (TOPUP_SUPPORTED) — the switch renders disabled and
nothing is called or stored.

## Request body

- TopupBody
  - `org_id` string, required
  - `enabled` boolean, required
  - `threshold_credits` integer, nullable
  - `recharge_to_credits` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/opero/apis/opero-pro-api.md) - [All operations](https://skmtc.dev/opero/apis/opero-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opero/apis/opero-pro-api/revisions/e6ede41aeb9b?raw)