Skip to main content
PATCH
Updates an existing price with partial data (PATCH semantics). Only provided fields are updated. Creation-only fields cannot be modified.

Authentication

string
required
Bearer token for authentication

Path Parameters

uuid
required
The unique identifier of the price to update

Request Body

All fields are optional. Only include the fields you want to update.
string
Pricing model: flat, volume, graduated, percent, cost_based, or none
number
Fixed price amount (for flat pricing)
array
Array of volume tier objects
boolean
Whether to display volume tiers to customers
array
Array of graduated tier objects
boolean
Whether to display graduated tiers to customers
number
Percentage value 0-100
string
Scope: all, product_type, or product
number
Multiplier for cost-based pricing
number
Base cost price
number
Minimum acceptable price
boolean
Whether this is a setup fee
boolean
Whether this uses pay-as-you-go billing
uuid
ID of the default sales tax
uuid
ID of billing frequency
string
forever or fixed_period
number
Number of billing periods
uuid
Parent price ID for dynamic pricebooks
string
External CRM identifier
string
External ERP identifier
string
External accounting identifier

Immutable Fields

The following fields cannot be modified after creation:
  • product_id
  • pricebook_id
  • currency_id

Response

boolean
Indicates if the request was successful
object
The updated price object with all fields and enriched data