---
title: Update Spend Policy
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Billing](https://developers.cloudflare.com/api/resources/billing)
[Spend Policies](https://developers.cloudflare.com/api/resources/billing/subresources/spend_policies)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Update Spend Policy
PUT/accounts/{account\_id}/billing/spend-policies/{policy\_id}
Replaces the whole spend policy. Every field is required, as on create; there are no partial updates and `PATCH` is not supported. The `If-Match` header must equal the policy’s current `version`. On success, `version` goes up by one and the new value is returned in `ETag`.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### P ath ParametersExpand Collapse
account\_id: string
Represents a Cloudflare resource identifier tag.
maxLength32
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
policy\_id: string
The unique identifier of the spend policy.
formatuuid
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20policy_id%20%3E%20(schema)>)
##### H eader ParametersExpand Collapse
"If-Match": string
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20If-Match%20%3E%20(schema)>)
##### Body ParametersJSONExpand Collapse
action: "notification"or "usage\_block"
The action taken when the threshold is reached. notification sends an email to notification_email. usage_block blocks further usage of the product until the end of the billing period. Raising the threshold above the current balance, disabling the policy, or deleting it lifts the block early.
One of the following:
"notification"
Link to this property
"usage\_block"
Link to this property
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20action%20%3E%20(schema)>)
enabled: boolean
Whether the policy is evaluated.
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20enabled%20%3E%20(schema)>)
name: string
Display name of the policy. After surrounding whitespace is trimmed, it must be 1 to 200 bytes long. The value is stored as sent, untrimmed.
minLength1
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>)
product\_id: "workers"or "durable\_objects"
The product the policy applies to: workers or durable_objects. Each product’s balance and policies are separate. Both products support notification and usage_block policies on create and update.
One of the following:
"workers"
Link to this property
"durable\_objects"
Link to this property
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20product_id%20%3E%20(schema)>)
threshold\_cents: number
The spend threshold for the current billing period, in US cents. Must be greater than zero.
formatint64
minimum1
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20threshold_cents%20%3E%20(schema)>)
notification\_email: optional string
Email address that receives notifications. Required when `action` is `notification`. When set, it must be a bare address (`user@example.com`); display-name forms such as `Name ` are rejected.
formatemail
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(params)%200%20%3E%20(param)%20notification_email%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of object {message, code }
Always empty on success.
message: string
Describes the error or notice.
Link to this property
code: optional number
Identifies the error or notice type.
Link to this property
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {message, code }
Contains informational notices about the response.
message: string
Describes the error or notice.
Link to this property
code: optional number
Identifies the error or notice type.
Link to this property
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: object {id, account\_id, action, 7 more }
A spend policy.
id: string
The unique identifier of the spend policy.
formatuuid
Link to this property
account\_id: number
Internal numeric ID of the account that owns the policy. This is not the account tag used in the path.
formatint64
Link to this property
action: "notification"or "usage\_block"
The action taken when the threshold is reached. notification sends an email to notification_email. usage_block blocks further usage of the product until the end of the billing period. Raising the threshold above the current balance, disabling the policy, or deleting it lifts the block early.
One of the following:
"notification"
Link to this property
"usage\_block"
Link to this property
Link to this property
enabled: boolean
Whether the policy is evaluated.
Link to this property
name: string
Display name of the policy.
Link to this property
notification\_email: string
Email address that receives notifications. An empty string when none is set.
Link to this property
product\_id: "workers"or "durable\_objects"
The product the policy applies to: workers or durable_objects. Each product’s balance and policies are separate. Both products support notification and usage_block policies on create and update.
One of the following:
"workers"
Link to this property
"durable\_objects"
Link to this property
Link to this property
threshold\_cents: number
The spend threshold for the current billing period, in US cents.
formatint64
Link to this property
version: number
Optimistic-concurrency version. It starts at 1 and goes up by one on every update or delete. This value is also returned in ETag.
formatint64
minimum1
Link to this property
current\_state: optional object {balance\_cents, billing\_period\_end, billing\_period\_start, 3 more }
Read-only state on list/get responses, evaluated from the latest owning projector snapshot at request time, independently of the API replica. Configuration enabled/version/ETag do not change when a cycle rolls over. Audit history remains unchanged. Missing during a rolling upgrade or on mutation responses; clients must treat missing state as unavailable. Balances are asynchronous estimates, not a synchronous usage read.
balance\_cents: number
formatint64
Link to this property
billing\_period\_end: string
formatdate-time
Link to this property
billing\_period\_start: string
formatdate-time
Link to this property
enforcement: object {applied\_generation, delivery\_status, desired\_generation, 2 more }
Durable desired cap and delivery bookkeeping for this policy, or null if no owned effect exists. Separate from threshold evaluation: pending/leased/retry can lag the new billing period. Succeeded with equal generations means delivery completed, not an EWC readback.
applied\_generation: number
formatint64
Link to this property
delivery\_status: "pending"or "leased"or "retry"or "succeeded"
One of the following:
"pending"
Link to this property
"leased"
Link to this property
"retry"
Link to this property
"succeeded"
Link to this property
Link to this property
desired\_generation: number
formatint64
Link to this property
desired\_state: "active"or "inactive"
One of the following:
"active"
Link to this property
"inactive"
Link to this property
Link to this property
expires\_at: string
formatdate-time
Link to this property
Link to this property
evaluated\_at: string
Evaluation time; not the timestamp of the latest usage event.
formatdate-time
Link to this property
status: "disabled"or "no\_current\_period"or "unavailable"or 2 more
Threshold evaluation, not proof of an edge cap. No current active period yields no\_current\_period for enabled policies; failed aggregate reads yield unavailable for enabled policies. Disabled policies report disabled. Neither no\_current\_period nor unavailable implies a zero balance or below-limit state. Operators may disable current-state reads, in which case current\_state is omitted.
One of the following:
"disabled"
Link to this property
"no\_current\_period"
Link to this property
"unavailable"
Link to this property
"below\_limit"
Link to this property
"limit\_reached"
Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: true
Indicates whether the API call was successful.
[Link to this property](<#(resource)%20billing.spend_policies%20%3E%20(method)%20update%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### Update Spend Policy
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billing/spend-policies/$POLICY_ID \
-X PUT \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{
"action": "notification",
"enabled": true,
"name": "Workers cap",
"product_id": "workers",
"threshold_cents": 100,
"notification_email": "billing@example.com"
}'
```
200 example
```
{
"errors": [
{
"message": "message",
"code": 0
}
],
"messages": [
{
"message": "message",
"code": 0
}
],
"result": {
"id": "6f1c2b8e-3d4a-4f5b-9c6d-7e8f9a0b1c2d",
"account_id": 1234567,
"action": "notification",
"enabled": true,
"name": "Workers cap",
"notification_email": "billing@example.com",
"product_id": "workers",
"threshold_cents": 100,
"version": 1,
"current_state": {
"balance_cents": 0,
"billing_period_end": "2019-12-27T18:11:19.117Z",
"billing_period_start": "2019-12-27T18:11:19.117Z",
"enforcement": {
"applied_generation": 0,
"delivery_status": "pending",
"desired_generation": 0,
"desired_state": "active",
"expires_at": "2019-12-27T18:11:19.117Z"
},
"evaluated_at": "2019-12-27T18:11:19.117Z",
"status": "disabled"
}
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"errors": [
{
"message": "message",
"code": 0
}
],
"messages": [
{
"message": "message",
"code": 0
}
],
"result": {
"id": "6f1c2b8e-3d4a-4f5b-9c6d-7e8f9a0b1c2d",
"account_id": 1234567,
"action": "notification",
"enabled": true,
"name": "Workers cap",
"notification_email": "billing@example.com",
"product_id": "workers",
"threshold_cents": 100,
"version": 1,
"current_state": {
"balance_cents": 0,
"billing_period_end": "2019-12-27T18:11:19.117Z",
"billing_period_start": "2019-12-27T18:11:19.117Z",
"enforcement": {
"applied_generation": 0,
"delivery_status": "pending",
"desired_generation": 0,
"desired_state": "active",
"expires_at": "2019-12-27T18:11:19.117Z"
},
"evaluated_at": "2019-12-27T18:11:19.117Z",
"status": "disabled"
}
},
"success": true
}
```