---
title: "Upsert a billing rate (admin only)"
method: POST
path: "/v1/billing/rates"
---

# Upsert a billing rate (admin only)

`POST /v1/billing/rates`

## Request

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

## Headers

- `X-API-KEY` string, nullable

## Request body

- UpsertRateRequest
  - `operation` string, required
  - `billing_type` string, required
  - `rate_per_page_usd` number, required

## Response `200`

Successful Response

- BillingRateItem
  - `id` integer, nullable
  - `operation` string, required
  - `billing_type` string, required
  - `rate_per_page_usd` number, required
  - `pricing_model` string
  - `flat_cost_usd` number, nullable
  - `flat_cost_usd_above_threshold` number, nullable
  - `page_threshold` integer, nullable
  - `is_active` boolean
  - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clichefactory/apis/aio-server.md) · [All operations](https://skmtc.dev/clichefactory/apis/aio-server/llms.txt) · [OpenAPI document](https://skmtc.dev/clichefactory/apis/aio-server/revisions/9bd59f9bbb31?raw)