--- title: Update Zone Subscription --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Zones](https://developers.cloudflare.com/api/go/resources/zones) [Subscriptions](https://developers.cloudflare.com/api/go/resources/zones/subresources/subscriptions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update Zone Subscription client.Zones.Subscriptions.Update(ctx, params) (\*[SubscriptionUpdateResponse](), error) PUT/zones/{zone\_id}/subscription Updates zone subscriptions, either plan or add-ons. ##### 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
##### Accepted Permissions (at least one required) `Billing Write` ##### ParametersExpand Collapse
params SubscriptionUpdateParams ZoneID param.Field\[string] Path param: Identifier maxLength32 Link to this property Subscription param.Field\[Subscription] Body param Link to this property
[Link to this property](<#(resource)%20zones.subscriptions%20%3E%20(method)%20update%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type SubscriptionUpdateResponse struct{…} ID stringOptional Subscription identifier tag. maxLength32 Link to this property Currency stringOptional The monetary unit in which pricing information is displayed. Link to this property CurrentPeriodEnd TimeOptional The end of the current period and also when the next billing is due. formatdate-time Link to this property CurrentPeriodStart TimeOptional When the current billing period started. May match initial\_period\_start if this is the first period. formatdate-time Link to this property
Frequency SubscriptionUpdateResponseFrequencyOptional How often the subscription is renewed automatically. One of the following: const SubscriptionUpdateResponseFrequencyWeekly SubscriptionUpdateResponseFrequency = "weekly" Link to this property const SubscriptionUpdateResponseFrequencyMonthly SubscriptionUpdateResponseFrequency = "monthly" Link to this property const SubscriptionUpdateResponseFrequencyQuarterly SubscriptionUpdateResponseFrequency = "quarterly" Link to this property const SubscriptionUpdateResponseFrequencyYearly SubscriptionUpdateResponseFrequency = "yearly" Link to this property const SubscriptionUpdateResponseFrequencyNotApplicable SubscriptionUpdateResponseFrequency = "not-applicable" Link to this property
Link to this property Price float64Optional The price of the subscription that will be billed, in US dollars. Link to this property
RatePlan RatePlanOptional The rate plan applied to the subscription.
ID RatePlanIDOptional The ID of the rate plan. One of the following: const RatePlanIDFree RatePlanID = "free" Link to this property const RatePlanIDLite RatePlanID = "lite" Link to this property const RatePlanIDPro RatePlanID = "pro" Link to this property const RatePlanIDProPlus RatePlanID = "pro\_plus" Link to this property const RatePlanIDBusiness RatePlanID = "business" Link to this property const RatePlanIDEnterprise RatePlanID = "enterprise" Link to this property const RatePlanIDPartnersFree RatePlanID = "partners\_free" Link to this property const RatePlanIDPartnersPro RatePlanID = "partners\_pro" Link to this property const RatePlanIDPartnersBusiness RatePlanID = "partners\_business" Link to this property const RatePlanIDPartnersEnterprise RatePlanID = "partners\_enterprise" Link to this property
Link to this property Currency stringOptional The currency applied to the rate plan subscription. Link to this property ExternallyManaged boolOptional Whether this rate plan is managed externally from Cloudflare. Link to this property IsContract boolOptional Whether a rate plan is enterprise-based (or newly adopted term contract). Link to this property PublicName stringOptional The full name of the rate plan. Link to this property Scope stringOptional The scope that this rate plan applies to. Link to this property Sets \[]stringOptional The list of sets this rate plan applies to. Returns array of strings. Link to this property
Link to this property
State SubscriptionUpdateResponseStateOptional The state that the subscription is in. One of the following: const SubscriptionUpdateResponseStateTrial SubscriptionUpdateResponseState = "Trial" Link to this property const SubscriptionUpdateResponseStateProvisioned SubscriptionUpdateResponseState = "Provisioned" Link to this property const SubscriptionUpdateResponseStatePaid SubscriptionUpdateResponseState = "Paid" Link to this property const SubscriptionUpdateResponseStateAwaitingPayment SubscriptionUpdateResponseState = "AwaitingPayment" Link to this property const SubscriptionUpdateResponseStateCancelled SubscriptionUpdateResponseState = "Cancelled" Link to this property const SubscriptionUpdateResponseStateFailed SubscriptionUpdateResponseState = "Failed" Link to this property const SubscriptionUpdateResponseStateExpired SubscriptionUpdateResponseState = "Expired" Link to this property
Link to this property
[Link to this property](<#(resource)%20zones.subscriptions%20%3E%20(model)%20SubscriptionUpdateResponse%20%3E%20(schema)>) ### Update Zone Subscription Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/shared" "github.com/cloudflare/cloudflare-go/zones" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) subscription, err := client.Zones.Subscriptions.Update(context.TODO(), zones.SubscriptionUpdateParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Subscription: shared.SubscriptionParam{ }, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", subscription.ID) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "id": "506e3185e9c882d175a2d0cb0093d9f2", "currency": "USD", "current_period_end": "2014-03-31T12:20:00Z", "current_period_start": "2014-05-11T12:20:00Z", "frequency": "monthly", "price": 20, "rate_plan": { "id": "free", "currency": "USD", "externally_managed": false, "is_contract": false, "public_name": "Business Plan", "scope": "zone", "sets": [ "string" ] }, "state": "Paid" }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": { "id": "506e3185e9c882d175a2d0cb0093d9f2", "currency": "USD", "current_period_end": "2014-03-31T12:20:00Z", "current_period_start": "2014-05-11T12:20:00Z", "frequency": "monthly", "price": 20, "rate_plan": { "id": "free", "currency": "USD", "externally_managed": false, "is_contract": false, "public_name": "Business Plan", "scope": "zone", "sets": [ "string" ] }, "state": "Paid" }, "success": true } ```