--- title: Settings --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Hostnames](https://developers.cloudflare.com/api/python/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/python/resources/hostnames/subresources/settings/subresources/tls/methods/list) hostnames.settings.tls.list(Literal\["ciphers", "min\_tls\_version", "http2"]setting\_id, TLSListParams\*\*kwargs) -> SyncSinglePage\[[TLSListResponse]()] GET/zones/{zone\_id}/hostnames/settings/{setting\_id} ##### [Get TLS setting for hostname](https://developers.cloudflare.com/api/python/resources/hostnames/subresources/settings/subresources/tls/methods/get) hostnames.settings.tls.get(strhostname, TLSGetParams\*\*kwargs) -> [Setting]() GET/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Edit TLS setting for hostname](https://developers.cloudflare.com/api/python/resources/hostnames/subresources/settings/subresources/tls/methods/update) hostnames.settings.tls.update(strhostname, TLSUpdateParams\*\*kwargs) -> [Setting]() PUT/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Delete TLS setting for hostname](https://developers.cloudflare.com/api/python/resources/hostnames/subresources/settings/subresources/tls/methods/delete) hostnames.settings.tls.delete(strhostname, TLSDeleteParams\*\*kwargs) -> [TLSDeleteResponse]() DELETE/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### ModelsExpand Collapse
class Setting: … created\_at: Optional\[datetime] This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property hostname: Optional\[str] The hostname for which the tls settings are set. Link to this property status: Optional\[str] Deployment status for the given tls setting. Link to this property updated\_at: Optional\[datetime] 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)>)
Union\[Literal\["1.0", "1.1", "1.2", 3 more], List\[str]] 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:
Literal\["1.0", "1.1", "1.2", 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 List\[str] 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)>)
class TLSListResponse: … created\_at: Optional\[datetime] This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property hostname: Optional\[str] The hostname for which the tls settings are set. Link to this property status: Optional\[str] Deployment status for the given tls setting. Link to this property updated\_at: Optional\[datetime] 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)%20tls_list_response%20%3E%20(schema)>)
class TLSDeleteResponse: … created\_at: Optional\[datetime] This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property hostname: Optional\[str] The hostname for which the tls settings are set. Link to this property status: Optional\[str] Deployment status for the given tls setting. Link to this property updated\_at: Optional\[datetime] 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)%20tls_delete_response%20%3E%20(schema)>)