---
title: "Add a price override"
method: POST
path: "/v1/contracts/{id}/overrides"
tags: ["Contracts"]
---

# Add a price override

`POST /v1/contracts/{id}/overrides`

Add or update a per-unit-type price override on a contract.

Price overrides replace the default pricing plan rate for a specific usage type. For example, if your default `api_call` plan charges $0.001/call, a contract override of $0.0008/call gives this customer a negotiated enterprise rate.

If an override for the given `unitType` already exists, it is updated (upsert behavior). Only ACTIVE contracts accept new overrides.

> **Requires a secret key (`sk_*`) with the `ADMIN` role.**

## Path parameters

- `id` string, required

## Request body

- object — Add or update a per-unit-type price override on a contract. If an override already exists for the given `unitType`, it is updated (upsert). Only ACTIVE contracts accept overrides.
  - `unitType` string, required — The usage type to override pricing for. Must match a `unitType` in your pricing plans (e.g., "api_call", "token").
  - `unitPriceUsd` string, required — Custom price per unit in USD. Must be a non-negative number as a string (for decimal precision). Use "0" for free-tier overrides.

## Response `201`

Price override created or updated

- object — Price override created or updated
  - `id` string, required — Unique identifier for the price override
  - `unitType` string, required — The usage type this override applies to (must match a pricing plan `unitType`)
  - `unitPriceUsd` string, required — Custom price per unit in USD (string for decimal precision, up to 6 decimal places)

## Other responses

- `400` — Contract is not in ACTIVE state, or validation error
- `401` — Unauthorized — missing or invalid API key
- `403` — Forbidden — API key does not have ADMIN role
- `404` — Contract not found

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/revisions/2cb1567969ca/schema)