# Turn renewals or automatic renewal on or off > Turn renewals or automatic renewal on or off: TrueProxies customer API reference with the required scope, parameters, responses and code samples. Source: https://docs.trueproxies.com/api/operations/patch_v1_services_id/ `PATCH /v1/services/{id}` **Fetch** ```js const url = 'https://api.trueproxies.com/v1/services/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'; const options = { method: 'PATCH', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"auto_pay":true,"auto_pay_consent":{"disclosure_text":"example","disclosure_version":"example"},"label":"example","renewals_enabled":true}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` **cURL** ```sh curl --request PATCH \ --url https://api.trueproxies.com/v1/services/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "auto_pay": true, "auto_pay_consent": { "disclosure_text": "example", "disclosure_version": "example" }, "label": "example", "renewals_enabled": true }' ``` Set renewals\_enabled or auto\_pay. Requires billing:write; reseller:purchase also permits this operation. Add customer\_id to change a managed customer’s service, which additionally requires reseller:purchase: a managed customer’s renewal is paid from the wallet automatically. Managed customers’ services start with renewals off. Turning renewals off cancels an open renewal invoice and turns automatic renewal off. Free trials and comparison passes cannot be renewed. auto\_pay charges the saved card for renewals (for automatic top-up on GB plans); turning it on needs a saved card and auto\_pay\_consent, the exact sentence the customer saw, and turning it off takes effect at once. Managed customers’ services cannot use automatic renewal. ## Authorizations - **[customerAPIKey](https://docs.trueproxies.com/api/#customerapikey)** ## Parameters ### Path Parameters - **id** required string format: uuid ### Query Parameters - **customer\_id** string format: uuid Owned sub-customer UUID. Resellers only; reads require reseller:read and writes reseller:purchase in addition to the operation scope. X-Customer-Id header is an alternative. Not allowed for me, wallet, trial, API keys, or reseller-management routes. ## Request Body (required) Media type: `application/json` object - **auto\_pay** Turns automatic renewal (automatic top-up on GB plans) on or off for this service. Off takes effect at once. On needs a saved card and auto\_pay\_consent, and cannot be sent with renewals\_enabled false on a plan that renews. boolean - **auto\_pay\_consent** Required when auto\_pay is true. object - **disclosure\_text** required Refused when blank or longer than 1000 characters, so the stored sentence is exactly what was shown. string \>= 1 characters <= 1000 characters - **disclosure\_version** required string \>= 1 characters <= 64 characters - **label** Your own name for this service, shown instead of the plan name. Leading and trailing spaces are trimmed; an empty string clears it. No line breaks or control characters. string <= 40 characters - **renewals\_enabled** boolean ##### Example (generated) ```json { "auto_pay": true, "auto_pay_consent": { "disclosure_text": "example", "disclosure_version": "example" }, "label": "example", "renewals_enabled": true } ``` ## Responses ### 200 Ok Media type: `application/json` object - **auto\_pay** required Automatic renewal is on (automatic top-up on GB plans). The saved card is charged without the customer paying the invoice. boolean - **auto\_pay\_available** required Automatic renewal can be turned on for this service now. boolean - **auto\_pay\_last\_failure** required Any of: **object** object - **at** required string format: date-time - **reason** required string **null** null - **billing\_read\_only** required Existing access remains available, but this service cannot be topped up or renewed. New plan purchases are separate. boolean - **capabilities** required Array\ - **city** string - **comparison\_pass** Free private comparison with fixed speed and expiry; cannot be purchased, topped up or renewed. boolean - **connects\_per\_second** required Effective limit for this service. integer - **created\_at** required string format: date-time - **depleted** boolean - **display\_name** required Unlimited service names reflect their actual speed and term; offer\_key retains the original billing plan. string - **expires\_at** string format: date-time - **grace\_until** string format: date-time - **host** required string - **id** required Internal API identifier. Use reference for customer-facing display. string format: uuid - **ips** The service’s IPs in order, for isp\_dedicated; empty until they are set up. Array\