Skip to content

Update a spend control with version fencing

PUT
/v1/admin/orgs/{org_id}/commerce/spend-limits/{limit_id}
org_id
required
string
limit_id
required
string
object
expected_version
integer format: int64
scope
required
string
Allowed values: org project agent
project_id
string
agent_id
string
name
required
string
currency
string
default: usd
cadence
required
string
Allowed values: does_not_repeat weekly monthly quarterly annually
budget_cents
required
integer format: int64
budget_enabled
required
boolean
per_purchase_max_cents
required
integer format: int64
per_purchase_enabled
required
boolean
domain_count_limit
required
integer format: int64
domain_count_enabled
required
boolean
allowed_tlds
Array<string>
allow_premium
required
boolean
active
boolean
expires_at
string format: date-time

Updated

object
expected_version
integer format: int64
scope
required
string
Allowed values: org project agent
project_id
string
agent_id
string
name
required
string
currency
string
default: usd
cadence
required
string
Allowed values: does_not_repeat weekly monthly quarterly annually
budget_cents
required
integer format: int64
budget_enabled
required
boolean
per_purchase_max_cents
required
integer format: int64
per_purchase_enabled
required
boolean
domain_count_limit
required
integer format: int64
domain_count_enabled
required
boolean
allowed_tlds
Array<string>
allow_premium
required
boolean
active
boolean
expires_at
string format: date-time
id
required
string
org_id
required
string
period_start
required
string format: date-time
period_end
string format: date-time
spent_cents
required
integer format: int64
reserved_cents
required
integer format: int64
purchased_count
required
integer format: int64
reserved_count
required
integer format: int64
version
required
integer format: int64
created_at
required
string format: date-time
updated_at
required
string format: date-time

Resource conflict (e.g. a duplicate entry).

The canonical error envelope. error is a stable machine code.

object
error
required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string
Example
forbidden
message

Human-readable detail (never leaks internals).

string
Example
missing required scope