---
title: "Replace Organization Pricing"
method: PUT
path: "/v1/organizations/me/pricing/{pricing_id}"
tags: ["organization-pricing"]
---

# Replace Organization Pricing

`PUT /v1/organizations/me/pricing/{pricing_id}`

Replace an override's rates and period.

Future requests in the period price at the new rate; usage already settled
keeps the cost it was billed, because a settled cost is stored on the usage
row rather than recomputed.

## Path parameters

- `pricing_id` string, uuid, required

## Request body

- OrganizationModelPricingUpdate — Replace an override's rates and period. ``effective_from`` is required here, where a create defaults it to now. A replacement states the whole row, so defaulting an omitted start would move a stored period to the present: an operator editing next quarter's rate through a client that does not send the field would silently bring it into effect today, or collide with the period that currently applies. Stating it is the only reading that cannot surprise. A full replacement rather than a patch: every rate field is present in the body and an omitted optional rate is cleared, so the stored row is exactly what was sent. That is the opposite of ``POST /v1/pricing``, which inherits an omitted cache rate from the model's previous version, and deliberately so: that surface versions a catalog where each write adds a row, while this one edits a single row in place and an inheriting patch would make the result depend on what happened to be stored before. ``model_key`` is absent because it is immutable. Repointing an override at another model is retiring one and creating another, which is two requests.
  - `cache_read_price_per_million` number, nullable — Price per 1M cached-input tokens
  - `cache_write_1h_price_per_million` number, nullable — Price per 1M Anthropic 1-hour cache-write tokens
  - `cache_write_price_per_million` number, nullable — Price per 1M cache-write (creation) tokens
  - `effective_from` string, date-time, required — ISO 8601 datetime from which this rate applies, inclusive. Required on a replacement, so an omitted value cannot silently move a stored period to the present.
  - `effective_to` string, date-time, nullable — ISO 8601 datetime at which this rate stops applying, exclusive. Null leaves it open ended. Because the end is exclusive, the next period may begin at exactly this instant without overlapping.
  - `input_price_per_million` number, required — Price per 1M input tokens
  - `output_price_per_million` number, required — Price per 1M output tokens
  - `pricing_tiers` PricingTier[], nullable — Whole-request context thresholds. Fields omitted by a tier inherit the base rate.
    - `cache_read_price_per_million` number, nullable
    - `cache_write_1h_price_per_million` number, nullable
    - `cache_write_price_per_million` number, nullable
    - `input_price_per_million` number, nullable
    - `min_input_tokens` integer, required
    - `output_price_per_million` number, nullable

## Response `200`

Successful Response

- OrganizationModelPricingPublic — One stored rate override.
  - `cache_read_price_per_million` number, nullable, required
  - `cache_write_1h_price_per_million` number, nullable, required
  - `cache_write_price_per_million` number, nullable, required
  - `created_at` string, date-time, required
  - `effective_from` string, date-time, required
  - `effective_to` string, date-time, nullable, required
  - `id` string, uuid, required
  - `input_price_per_million` number, required
  - `model_key` string, required
  - `organization_id` string, uuid, required
  - `output_price_per_million` number, required
  - `pricing_tiers` PricingTier[], required
    - `cache_read_price_per_million` number, nullable
    - `cache_write_1h_price_per_million` number, nullable
    - `cache_write_price_per_million` number, nullable
    - `input_price_per_million` number, nullable
    - `min_input_tokens` integer, required
    - `output_price_per_million` number, nullable
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/a4401e66e263/schema)