--- title: Settings --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Hostnames](https://developers.cloudflare.com/api/resources/hostnames) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Settings #### SettingsTLS ##### [List TLS setting for hostnames](https://developers.cloudflare.com/api/resources/hostnames/subresources/settings/subresources/tls/methods/list) GET/zones/{zone\_id}/hostnames/settings/{setting\_id} ##### [Get TLS setting for hostname](https://developers.cloudflare.com/api/resources/hostnames/subresources/settings/subresources/tls/methods/get) GET/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Edit TLS setting for hostname](https://developers.cloudflare.com/api/resources/hostnames/subresources/settings/subresources/tls/methods/update) PUT/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Delete TLS setting for hostname](https://developers.cloudflare.com/api/resources/hostnames/subresources/settings/subresources/tls/methods/delete) DELETE/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### ModelsExpand Collapse

Setting object {created\_at, hostname, status, 2 more }

created\_at: optional string This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property hostname: optional string The hostname for which the tls settings are set. Link to this property status: optional string Deployment status for the given tls setting. Link to this property updated\_at: optional string This is the time the tls setting was updated. formatdate-time Link to this property value: optional SettingValue 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)>)

SettingValue = "1.0"or "1.1"or "1.2"or 3 moreor array of string 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:

"1.0"or "1.1"or "1.2"or 3 more

One of the following: "1.0" Link to this property "1.1" Link to this property "1.2" Link to this property "1.3" Link to this property "on" Link to this property "off" Link to this property

Link to this property array of 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)>)

TLSListResponse object {created\_at, hostname, status, 2 more }

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(model)%20tls_list_response%20%3E%20(schema)>)

TLSDeleteResponse object {created\_at, hostname, status, 2 more }

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(model)%20tls_delete_response%20%3E%20(schema)>)