---
title: "Set Billing Hold"
method: PUT
path: "/api/billing/apps/{name}/billing-hold"
tags: ["billing"]
---

# Set Billing Hold

`PUT /api/billing/apps/{name}/billing-hold`

## Request

- Base URL: `https://softkiln.com` (the document declares no server; this is the origin it was published from)
- URL: `https://softkiln.com/api/billing/apps/{name}/billing-hold`
- Auth: none declared

Super-admin "treat as no payment" switch. Setting it true disconnects the
app immediately (and emails the owner the first time); clearing it restores
the app if it's otherwise paid up. The daily sweep enforces the same rule
going forward.

Setting it on an app that is already suspended re-asserts the disconnect
rather than doing nothing — the only manual way to take a paused app down
without waiting for the sweep. It does not restart the deletion clock.

## Path parameters

- `name` string, required

## Request body

- HoldRequest
  - `hold` boolean, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/softkiln/apis/app-manager-api.md) · [All operations](https://skmtc.dev/softkiln/apis/app-manager-api/llms.txt) · [OpenAPI document](https://skmtc.dev/softkiln/apis/app-manager-api/revisions/de2b674a7f21?raw)