--- title: Update User Subscription --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [User](https://developers.cloudflare.com/api/python/resources/user) [Subscriptions](https://developers.cloudflare.com/api/python/resources/user/subresources/subscriptions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update User Subscription user.subscriptions.update(stridentifier, SubscriptionUpdateParams\*\*kwargs) -> [SubscriptionUpdateResponse]() PUT/user/subscriptions/{identifier} Updates a user’s subscriptions. ##### 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 identifier: str Subscription identifier tag. maxLength32 [Link to this property](<#(resource)%20user.subscriptions%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20identifier%20%3E%20(schema)>)
frequency: Optional\[Literal\["weekly", "monthly", "quarterly", "yearly"]] How often the subscription is renewed automatically. One of the following: "weekly" Link to this property "monthly" Link to this property "quarterly" Link to this property "yearly" Link to this property
[Link to this property](<#(resource)%20user.subscriptions%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20frequency%20%3E%20(schema)>)
rate\_plan: Optional\[RatePlan] The rate plan applied to the subscription.
id: Optional\[Literal\["free", "lite", "pro", 7 more]] The ID of the rate plan. One of the following: "free" Link to this property "lite" Link to this property "pro" Link to this property "pro\_plus" Link to this property "business" Link to this property "enterprise" Link to this property "partners\_free" Link to this property "partners\_pro" Link to this property "partners\_business" Link to this property "partners\_enterprise" Link to this property
Link to this property currency: Optional\[str] The currency applied to the rate plan subscription. Link to this property externally\_managed: Optional\[bool] Whether this rate plan is managed externally from Cloudflare. Link to this property is\_contract: Optional\[bool] Whether a rate plan is enterprise-based (or newly adopted term contract). Link to this property public\_name: Optional\[str] The full name of the rate plan. Link to this property scope: Optional\[str] The scope that this rate plan applies to. Link to this property sets: Optional\[List\[str]] The list of sets this rate plan applies to. Returns array of strings. Link to this property
[Link to this property](<#(resource)%20user.subscriptions%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20rate_plan%20%3E%20(schema)>) ##### ReturnsExpand Collapse
Union\[Optional\[str], Optional\[object]] One of the following: Optional\[str] Link to this property Optional\[object] Link to this property
[Link to this property](<#(resource)%20user.subscriptions%20%3E%20(model)%20subscription_update_response%20%3E%20(schema)>) ### Update User Subscription Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) subscription = client.user.subscriptions.update( identifier="506e3185e9c882d175a2d0cb0093d9f2", ) print(subscription) ``` 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": {}, "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": {}, "success": true } ```