--- title: Settings --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Hostnames](https://developers.cloudflare.com/api/typescript/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/typescript/resources/hostnames/subresources/settings/subresources/tls/methods/list) client.hostnames.settings.tls.list("ciphers"| "min\_tls\_version"| "http2"settingID, TLSListParams {zone\_id } params, RequestOptionsoptions?): SinglePage< [TLSListResponse]() {created\_at, hostname, status, 2 more } > GET/zones/{zone\_id}/hostnames/settings/{setting\_id} ##### [Get TLS setting for hostname](https://developers.cloudflare.com/api/typescript/resources/hostnames/subresources/settings/subresources/tls/methods/get) client.hostnames.settings.tls.get(stringhostname, TLSGetParams {zone\_id, setting\_id } params, RequestOptionsoptions?): [Setting]() {created\_at, hostname, status, 2 more } GET/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Edit TLS setting for hostname](https://developers.cloudflare.com/api/typescript/resources/hostnames/subresources/settings/subresources/tls/methods/update) client.hostnames.settings.tls.update(stringhostname, TLSUpdateParams {zone\_id, setting\_id, value } params, RequestOptionsoptions?): [Setting]() {created\_at, hostname, status, 2 more } PUT/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### [Delete TLS setting for hostname](https://developers.cloudflare.com/api/typescript/resources/hostnames/subresources/settings/subresources/tls/methods/delete) client.hostnames.settings.tls.delete(stringhostname, TLSDeleteParams {zone\_id, setting\_id } params, RequestOptionsoptions?): [TLSDeleteResponse]() {created\_at, hostname, status, 2 more } DELETE/zones/{zone\_id}/hostnames/settings/{setting\_id}/{hostname} ##### ModelsExpand Collapse
Setting {created\_at, hostname, status, 2 more } created\_at?: string This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property hostname?: string The hostname for which the tls settings are set. Link to this property status?: string Deployment status for the given tls setting. Link to this property updated\_at?: string This is the time the tls setting was updated. formatdate-time Link to this property value?: 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"| "1.1"| "1.2"| 3 more| Array<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"| "1.1"| "1.2"| 3 more "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<string> Link to this property
[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(model)%20setting_value%20%3E%20(schema)>)
TLSListResponse {created\_at, hostname, status, 2 more } created\_at?: string This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property hostname?: string The hostname for which the tls settings are set. Link to this property status?: string Deployment status for the given tls setting. Link to this property updated\_at?: string This is the time the tls setting was updated. formatdate-time Link to this property value?: 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)>)
TLSDeleteResponse {created\_at, hostname, status, 2 more } created\_at?: string This is the time the tls setting was originally created for this hostname. formatdate-time Link to this property hostname?: string The hostname for which the tls settings are set. Link to this property status?: string Deployment status for the given tls setting. Link to this property updated\_at?: string This is the time the tls setting was updated. formatdate-time Link to this property value?: 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)>)