---
title: "Save auto top-up settings"
method: POST
path: "/v1/billing/autotopup"
tags: ["billing"]
---

# Save auto top-up settings

`POST /v1/billing/autotopup`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/billing/autotopup`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Save auto top-up settings after card is confirmed via SetupIntent. Validates threshold/amount constraints and verifies payment method with Stripe.

## Request body

- AutoTopupSettings
  - `enabled` boolean
  - `threshold` number, required
  - `amount` number, required
  - `payment_method_id` string, nullable

## Response `200`

Settings saved

- unknown

## Other responses

- `400`: Invalid settings
- `401`: Authentication required
- `422`: Validation Error

---

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