--- title: Enable or Disable Total TLS --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [ACM](https://developers.cloudflare.com/api/go/resources/acm) [Total TLS](https://developers.cloudflare.com/api/go/resources/acm/subresources/total_tls) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Enable or Disable Total TLS client.ACM.TotalTLS.Edit(ctx, params) (\*[TotalTLSEditResponse](), error) POST/zones/{zone\_id}/acm/total\_tls Set Total TLS Settings or disable the feature for a Zone. ##### 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) `SSL and Certificates Write` ##### ParametersExpand Collapse
params TotalTLSEditParams ZoneID param.Field\[string] Path param: Identifier. maxLength32 Link to this property Enabled param.Field\[bool] Body param: If enabled, Total TLS will order a hostname specific TLS certificate for any proxied A, AAAA, or CNAME record in your zone. Link to this property CertificateAuthority param.Field\[CertificateAuthority]Optional Body param: The Certificate Authority that Total TLS certificates will be issued through. Link to this property
[Link to this property](<#(resource)%20acm.total_tls%20%3E%20(method)%20edit%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type TotalTLSEditResponse struct{…}
CertificateAuthority CertificateAuthorityOptional The Certificate Authority that Total TLS certificates will be issued through. One of the following: const CertificateAuthorityGoogle CertificateAuthority = "google" Link to this property const CertificateAuthorityLetsEncrypt CertificateAuthority = "lets\_encrypt" Link to this property const CertificateAuthoritySSLCom CertificateAuthority = "ssl\_com" Link to this property
Link to this property Enabled boolOptional If enabled, Total TLS will order a hostname specific TLS certificate for any proxied A, AAAA, or CNAME record in your zone. Link to this property ValidityPeriod TotalTLSEditResponseValidityPeriodOptional The validity period in days for the certificates ordered via Total TLS. Link to this property
[Link to this property](<#(resource)%20acm.total_tls%20%3E%20(model)%20TotalTLSEditResponse%20%3E%20(schema)>) ### Enable or Disable Total TLS Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/acm" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.ACM.TotalTLS.Edit(context.TODO(), acm.TotalTLSEditParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Enabled: cloudflare.F(true), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.ValidityPeriod) } ``` 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" } } ], "success": true, "result": { "certificate_authority": "google", "enabled": true, "validity_period": 90 } } ``` ##### 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" } } ], "success": true, "result": { "certificate_authority": "google", "enabled": true, "validity_period": 90 } } ```