---
title: "Update billing settings"
method: POST
path: "/billing/settings"
tags: ["billing"]
---

# Update billing settings

`POST /billing/settings`

## Request

- Base URL: `https://api.schematichq.com`
- URL: `https://api.schematichq.com/billing/settings`
- Auth: API key in header `X-Schematic-Api-Key`

## Request body

- UpdateBillingSettingsRequestBody
  - `default_provider_type` 'metronome' | 'orb' | 'schematic' | 'stripe'

## Response `200`

OK

- object
  - `data` BillingSettingsResponseData, required
    - `default_provider_type` 'metronome' | 'orb' | 'schematic' | 'stripe'
  - `params` object, required — Input parameters

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Server error

## Changes

> 193 revisions in range; 2 not diffed.

- **2026-10-06** `353552436714` — 1 info
  - endpoint added

[Operation history](https://skmtc.dev/schematichq/apis/schematic-api/changes/billing/settings/post.md)

---

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