--- title: Hostnames --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Hostnames #### HostnamesSettings #### HostnamesSettingsTLS ##### [List TLS setting for hostnames](https://developers.cloudflare.com/api/go/resources/hostnames/subresources/settings/subresources/tls/methods/list) client.Hostnames.Settings.TLS.List(ctx, settingID, query) (\*SinglePage\[[SettingTLSListResponse]()], error) GET/zones/{zone\_id}/hostnames/settings/{setting\_id} ##### [Get TLS setting for hostname](https://developers.cloudflare.com/api/go/resources/hostnames/subresources/settings/subresources/tls/methods/get) client.Hostnames.Settings.TLS.Get(ctx, settingID, hostname, query) (\*[Setting](), error) GET/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Edit TLS setting for hostname](https://developers.cloudflare.com/api/go/resources/hostnames/subresources/settings/subresources/tls/methods/update) client.Hostnames.Settings.TLS.Update(ctx, settingID, hostname, params) (\*[Setting](), error) PUT/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Delete TLS setting for hostname](https://developers.cloudflare.com/api/go/resources/hostnames/subresources/settings/subresources/tls/methods/delete) client.Hostnames.Settings.TLS.Delete(ctx, settingID, hostname, body) (\*[SettingTLSDeleteResponse](), error) DELETE/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### ModelsExpand Collapse
type Setting struct{…} CreatedAt TimeOptional This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property Hostname stringOptional The hostname for which the tls settings are set. Link to this property Status stringOptional Deployment status for the given tls setting. Link to this property UpdatedAt TimeOptional This is the time the tls setting was updated. formatdate-time Link to this property Value SettingValueUnionOptional The TLS setting value. The type depends on the setting_id used in the request path: - ciphers: an array of allowed cipher suite strings in BoringSSL format (e.g., ["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]). - min_tls_version: a string indicating the minimum TLS version — one of "1.0", "1.1", "1.2", or "1.3" (e.g., "1.2"). - http2: a string indicating whether HTTP/2 is enabled — "on" or "off" (e.g., "on"). Link to this property
[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(model)%20setting%20%3E%20(schema)>)
type SettingValueUnion interface{…} The TLS setting value. The type depends on the setting_id used in the request path: - ciphers: an array of allowed cipher suite strings in BoringSSL format (e.g., ["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]). - min_tls_version: a string indicating the minimum TLS version — one of "1.0", "1.1", "1.2", or "1.3" (e.g., "1.2"). - http2: a string indicating whether HTTP/2 is enabled — "on" or "off" (e.g., "on"). One of the following:
type SettingValueString string One of the following: const SettingValueString1\_0 SettingValueString = "1.0" Link to this property const SettingValueString1\_1 SettingValueString = "1.1" Link to this property const SettingValueString1\_2 SettingValueString = "1.2" Link to this property const SettingValueString1\_3 SettingValueString = "1.3" Link to this property const SettingValueStringOn SettingValueString = "on" Link to this property const SettingValueStringOff SettingValueString = "off" Link to this property
Link to this property type SettingValueArray \[]string Used when setting_id is ciphers. An array of allowed cipher suite strings. Link to this property
[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(model)%20setting_value%20%3E%20(schema)>)