---
title: Settings
---

[Skip to content](#%5Ftop) 

[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](https://developers.cloudflare.com/api/typescript/resources/hostnames#%28resource%29%20hostnames.settings.tls%20%3E%20%28model%29%20tls%5Flist%5Fresponse%20%3E%20%28schema%29) { 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](https://developers.cloudflare.com/api/typescript/resources/hostnames#%28resource%29%20hostnames.settings.tls%20%3E%20%28model%29%20setting%20%3E%20%28schema%29) { 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](https://developers.cloudflare.com/api/typescript/resources/hostnames#%28resource%29%20hostnames.settings.tls%20%3E%20%28model%29%20setting%20%3E%20%28schema%29) { 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](https://developers.cloudflare.com/api/typescript/resources/hostnames#%28resource%29%20hostnames.settings.tls%20%3E%20%28model%29%20tls%5Fdelete%5Fresponse%20%3E%20%28schema%29) { 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

hostname?: string

The hostname for which the tls settings are set.

status?: string

Deployment status for the given tls setting.

updated\_at?: string

This is the time the tls setting was updated.

formatdate-time

value?: [SettingValue](https://developers.cloudflare.com/api/typescript/resources/hostnames#%28resource%29%20hostnames.settings.tls%20%3E%20%28model%29%20setting%5Fvalue%20%3E%20%28schema%29)

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"`).

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"

"1.1"

"1.2"

"1.3"

"on"

"off"

Array<string\>

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

hostname?: string

The hostname for which the tls settings are set.

status?: string

Deployment status for the given tls setting.

updated\_at?: string

This is the time the tls setting was updated.

formatdate-time

value?: [SettingValue](https://developers.cloudflare.com/api/typescript/resources/hostnames#%28resource%29%20hostnames.settings.tls%20%3E%20%28model%29%20setting%5Fvalue%20%3E%20%28schema%29)

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"`).

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

hostname?: string

The hostname for which the tls settings are set.

status?: string

Deployment status for the given tls setting.

updated\_at?: string

This is the time the tls setting was updated.

formatdate-time

value?: [SettingValue](https://developers.cloudflare.com/api/typescript/resources/hostnames#%28resource%29%20hostnames.settings.tls%20%3E%20%28model%29%20setting%5Fvalue%20%3E%20%28schema%29)

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"`).