--- title: Apps --- [Skip to content](#%5Ftop) [API Reference](https://developers.cloudflare.com/api/typescript) [Spectrum](https://developers.cloudflare.com/api/typescript/resources/spectrum) Copy Markdown Open in **Claude** Open in **ChatGPT** Open in **Cursor** --- **Copy Markdown** **View as Markdown** # Apps ##### [List Spectrum applications](https://developers.cloudflare.com/api/typescript/resources/spectrum/subresources/apps/methods/list) client.spectrum.apps.list(AppListParams { zone\_id, direction, order, 2 more } params, RequestOptionsoptions?): V4PagePaginationArray<[AppListResponse](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum.apps%20%3E%20%28model%29%20app%5Flist%5Fresponse%20%3E%20%28schema%29)\> GET/zones/{zone\_id}/spectrum/apps ##### [Get Spectrum application configuration](https://developers.cloudflare.com/api/typescript/resources/spectrum/subresources/apps/methods/get) client.spectrum.apps.get(stringappID, AppGetParams { zone\_id } params, RequestOptionsoptions?): [AppGetResponse](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum.apps%20%3E%20%28model%29%20app%5Fget%5Fresponse%20%3E%20%28schema%29) GET/zones/{zone\_id}/spectrum/apps/{app\_id} ##### [Create Spectrum application using a name for the origin](https://developers.cloudflare.com/api/typescript/resources/spectrum/subresources/apps/methods/create) client.spectrum.apps.create(AppCreateParamsparams, RequestOptionsoptions?): [AppCreateResponse](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum.apps%20%3E%20%28model%29%20app%5Fcreate%5Fresponse%20%3E%20%28schema%29) POST/zones/{zone\_id}/spectrum/apps ##### [Update Spectrum application configuration using a name for the origin](https://developers.cloudflare.com/api/typescript/resources/spectrum/subresources/apps/methods/update) client.spectrum.apps.update(stringappID, AppUpdateParamsparams, RequestOptionsoptions?): [AppUpdateResponse](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum.apps%20%3E%20%28model%29%20app%5Fupdate%5Fresponse%20%3E%20%28schema%29) PUT/zones/{zone\_id}/spectrum/apps/{app\_id} ##### [Delete Spectrum application](https://developers.cloudflare.com/api/typescript/resources/spectrum/subresources/apps/methods/delete) client.spectrum.apps.delete(stringappID, AppDeleteParams { zone\_id } params, RequestOptionsoptions?): [AppDeleteResponse](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum.apps%20%3E%20%28model%29%20app%5Fdelete%5Fresponse%20%3E%20%28schema%29) { id } | null DELETE/zones/{zone\_id}/spectrum/apps/{app\_id} ##### ModelsExpand Collapse AppListResponse \= SpectrumConfigAppConfig { id, created\_on, dns, 12 more } | SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } One of the following: SpectrumConfigAppConfig { id, created\_on, dns, 12 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. traffic\_type: "direct" | "http" | "https" Determines how data travels from the edge to your origin. When set to “direct”, Spectrum will send traffic directly to your origin, and the application’s type is derived from the `protocol`. When set to “http” or “https”, Spectrum will apply Cloudflare’s HTTP/HTTPS features as it sends traffic to your origin, and the application type matches this property exactly. One of the following: "direct" "http" "https" argo\_smart\_routing?: boolean Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. edge\_ips?: [EdgeIPs](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20edge%5Fips%20%3E%20%28schema%29) The anycast edge IP configuration for the hostname of this application. ip\_firewall?: boolean Enables IP Access Rules for this application. Notes: Only available for TCP applications. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. origin\_dns?: [OriginDNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fdns%20%3E%20%28schema%29) { name, ttl, type } The name and type of DNS record for the Spectrum application. origin\_port?: [OriginPort](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fport%20%3E%20%28schema%29) The destination port at the origin. Only specified in conjunction with origin\_dns. May use an integer to specify a single origin port, for example `1000`, or a string to specify a range of origin ports, for example `"1000-2000"`. Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the “protocol” field. maximum65535 minimum1 proxy\_protocol?: "off" | "v1" | "v2" | "simple" Enables Proxy Protocol to the origin. Refer to [Enable Proxy protocol](https://developers.cloudflare.com/spectrum/getting-started/proxy-protocol/) for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" "v1" "v2" "simple" tls?: "off" | "flexible" | "full" | "strict" The type of TLS termination associated with the application. One of the following: "off" "flexible" "full" "strict" virtual\_network\_id?: string Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. AppGetResponse \= SpectrumConfigAppConfig { id, created\_on, dns, 12 more } | SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } One of the following: SpectrumConfigAppConfig { id, created\_on, dns, 12 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. traffic\_type: "direct" | "http" | "https" Determines how data travels from the edge to your origin. When set to “direct”, Spectrum will send traffic directly to your origin, and the application’s type is derived from the `protocol`. When set to “http” or “https”, Spectrum will apply Cloudflare’s HTTP/HTTPS features as it sends traffic to your origin, and the application type matches this property exactly. One of the following: "direct" "http" "https" argo\_smart\_routing?: boolean Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. edge\_ips?: [EdgeIPs](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20edge%5Fips%20%3E%20%28schema%29) The anycast edge IP configuration for the hostname of this application. ip\_firewall?: boolean Enables IP Access Rules for this application. Notes: Only available for TCP applications. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. origin\_dns?: [OriginDNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fdns%20%3E%20%28schema%29) { name, ttl, type } The name and type of DNS record for the Spectrum application. origin\_port?: [OriginPort](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fport%20%3E%20%28schema%29) The destination port at the origin. Only specified in conjunction with origin\_dns. May use an integer to specify a single origin port, for example `1000`, or a string to specify a range of origin ports, for example `"1000-2000"`. Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the “protocol” field. maximum65535 minimum1 proxy\_protocol?: "off" | "v1" | "v2" | "simple" Enables Proxy Protocol to the origin. Refer to [Enable Proxy protocol](https://developers.cloudflare.com/spectrum/getting-started/proxy-protocol/) for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" "v1" "v2" "simple" tls?: "off" | "flexible" | "full" | "strict" The type of TLS termination associated with the application. One of the following: "off" "flexible" "full" "strict" virtual\_network\_id?: string Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. AppCreateResponse \= SpectrumConfigAppConfig { id, created\_on, dns, 12 more } | SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } One of the following: SpectrumConfigAppConfig { id, created\_on, dns, 12 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. traffic\_type: "direct" | "http" | "https" Determines how data travels from the edge to your origin. When set to “direct”, Spectrum will send traffic directly to your origin, and the application’s type is derived from the `protocol`. When set to “http” or “https”, Spectrum will apply Cloudflare’s HTTP/HTTPS features as it sends traffic to your origin, and the application type matches this property exactly. One of the following: "direct" "http" "https" argo\_smart\_routing?: boolean Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. edge\_ips?: [EdgeIPs](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20edge%5Fips%20%3E%20%28schema%29) The anycast edge IP configuration for the hostname of this application. ip\_firewall?: boolean Enables IP Access Rules for this application. Notes: Only available for TCP applications. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. origin\_dns?: [OriginDNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fdns%20%3E%20%28schema%29) { name, ttl, type } The name and type of DNS record for the Spectrum application. origin\_port?: [OriginPort](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fport%20%3E%20%28schema%29) The destination port at the origin. Only specified in conjunction with origin\_dns. May use an integer to specify a single origin port, for example `1000`, or a string to specify a range of origin ports, for example `"1000-2000"`. Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the “protocol” field. maximum65535 minimum1 proxy\_protocol?: "off" | "v1" | "v2" | "simple" Enables Proxy Protocol to the origin. Refer to [Enable Proxy protocol](https://developers.cloudflare.com/spectrum/getting-started/proxy-protocol/) for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" "v1" "v2" "simple" tls?: "off" | "flexible" | "full" | "strict" The type of TLS termination associated with the application. One of the following: "off" "flexible" "full" "strict" virtual\_network\_id?: string Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. AppUpdateResponse \= SpectrumConfigAppConfig { id, created\_on, dns, 12 more } | SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } One of the following: SpectrumConfigAppConfig { id, created\_on, dns, 12 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. traffic\_type: "direct" | "http" | "https" Determines how data travels from the edge to your origin. When set to “direct”, Spectrum will send traffic directly to your origin, and the application’s type is derived from the `protocol`. When set to “http” or “https”, Spectrum will apply Cloudflare’s HTTP/HTTPS features as it sends traffic to your origin, and the application type matches this property exactly. One of the following: "direct" "http" "https" argo\_smart\_routing?: boolean Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. edge\_ips?: [EdgeIPs](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20edge%5Fips%20%3E%20%28schema%29) The anycast edge IP configuration for the hostname of this application. ip\_firewall?: boolean Enables IP Access Rules for this application. Notes: Only available for TCP applications. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. origin\_dns?: [OriginDNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fdns%20%3E%20%28schema%29) { name, ttl, type } The name and type of DNS record for the Spectrum application. origin\_port?: [OriginPort](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20origin%5Fport%20%3E%20%28schema%29) The destination port at the origin. Only specified in conjunction with origin\_dns. May use an integer to specify a single origin port, for example `1000`, or a string to specify a range of origin ports, for example `"1000-2000"`. Notes: If specifying a port range, the number of ports in the range must match the number of ports specified in the “protocol” field. maximum65535 minimum1 proxy\_protocol?: "off" | "v1" | "v2" | "simple" Enables Proxy Protocol to the origin. Refer to [Enable Proxy protocol](https://developers.cloudflare.com/spectrum/getting-started/proxy-protocol/) for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" "v1" "v2" "simple" tls?: "off" | "flexible" | "full" | "strict" The type of TLS termination associated with the application. One of the following: "off" "flexible" "full" "strict" virtual\_network\_id?: string Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid SpectrumConfigPaygoAppConfig { id, created\_on, dns, 3 more } id: string App identifier. maxLength32 created\_on: string When the Application was created. formatdate-time dns: [DNS](https://developers.cloudflare.com/api/typescript/resources/spectrum#%28resource%29%20spectrum%20%3E%20%28model%29%20dns%20%3E%20%28schema%29) { name, type } The name and type of DNS record for the Spectrum application. modified\_on: string When the Application was last modified. formatdate-time protocol: string The port configuration at Cloudflare’s edge. May specify a single port, for example `"tcp/1000"`, or a range of ports, for example `"tcp/1000-2000"`. origin\_direct?: Array List of origin IP addresses. Array may contain multiple IP addresses for load balancing. AppDeleteResponse { id } id: string Identifier. maxLength32