--- title: Apps --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Spectrum](https://developers.cloudflare.com/api/python/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/python/resources/spectrum/subresources/apps/methods/list) spectrum.apps.list(AppListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[AppListResponse]()] GET/zones/{zone\_id}/spectrum/apps ##### [Get Spectrum application configuration](https://developers.cloudflare.com/api/python/resources/spectrum/subresources/apps/methods/get) spectrum.apps.get(strapp\_id, AppGetParams\*\*kwargs) -> [AppGetResponse]() GET/zones/{zone\_id}/spectrum/apps/{app\_id} ##### [Create Spectrum application using a name for the origin](https://developers.cloudflare.com/api/python/resources/spectrum/subresources/apps/methods/create) spectrum.apps.create(AppCreateParams\*\*kwargs) -> [AppCreateResponse]() POST/zones/{zone\_id}/spectrum/apps ##### [Update Spectrum application configuration using a name for the origin](https://developers.cloudflare.com/api/python/resources/spectrum/subresources/apps/methods/update) spectrum.apps.update(strapp\_id, AppUpdateParams\*\*kwargs) -> [AppUpdateResponse]() PUT/zones/{zone\_id}/spectrum/apps/{app\_id} ##### [Delete Spectrum application](https://developers.cloudflare.com/api/python/resources/spectrum/subresources/apps/methods/delete) spectrum.apps.delete(strapp\_id, AppDeleteParams\*\*kwargs) -> [AppDeleteResponse]() DELETE/zones/{zone\_id}/spectrum/apps/{app\_id} ##### ModelsExpand Collapse
AppListResponse One of the following:
class SpectrumConfigAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property
traffic\_type: Literal\["direct", "http", "https", "worker"] 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. When set to “worker”, traffic is sent to the Worker specified by origin_worker_id. One of the following: "direct" Link to this property "http" Link to this property "https" Link to this property "worker" Link to this property
Link to this property argo\_smart\_routing: Optional\[bool] Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. Link to this property edge\_ips: Optional\[EdgeIPs] The anycast edge IP configuration for the hostname of this application. Link to this property ip\_firewall: Optional\[bool] Enables IP Access Rules for this application. Notes: Only available for TCP applications. Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property origin\_dns: Optional\[OriginDNS] The name and type of DNS record for the Spectrum application. Link to this property origin\_port: Optional\[OriginPort] 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 Link to this property origin\_worker\_id: Optional\[str] Optional Worker script tag (worker ID) to use as the application’s origin. Only supported for TCP applications with traffic\_type “worker”; mutually exclusive with origin\_direct, origin\_dns, origin\_port, proxy\_protocol, and argo\_smart\_routing. tls may only be “off” or “flexible”. Link to this property
proxy\_protocol: Optional\[Literal\["off", "v1", "v2", "simple"]] Enables Proxy Protocol to the origin. Refer to Enable Proxy protocol for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" Link to this property "v1" Link to this property "v2" Link to this property "simple" Link to this property
Link to this property
tls: Optional\[Literal\["off", "flexible", "full", "strict"]] The type of TLS termination associated with the application. One of the following: "off" Link to this property "flexible" Link to this property "full" Link to this property "strict" Link to this property
Link to this property virtual\_network\_id: Optional\[str] Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid Link to this property
Link to this property
class SpectrumConfigPaygoAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property
Link to this property
[Link to this property](<#(resource)%20spectrum.apps%20%3E%20(model)%20app_list_response%20%3E%20(schema)>)
AppGetResponse One of the following:
class SpectrumConfigAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property
traffic\_type: Literal\["direct", "http", "https", "worker"] 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. When set to “worker”, traffic is sent to the Worker specified by origin_worker_id. One of the following: "direct" Link to this property "http" Link to this property "https" Link to this property "worker" Link to this property
Link to this property argo\_smart\_routing: Optional\[bool] Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. Link to this property edge\_ips: Optional\[EdgeIPs] The anycast edge IP configuration for the hostname of this application. Link to this property ip\_firewall: Optional\[bool] Enables IP Access Rules for this application. Notes: Only available for TCP applications. Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property origin\_dns: Optional\[OriginDNS] The name and type of DNS record for the Spectrum application. Link to this property origin\_port: Optional\[OriginPort] 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 Link to this property origin\_worker\_id: Optional\[str] Optional Worker script tag (worker ID) to use as the application’s origin. Only supported for TCP applications with traffic\_type “worker”; mutually exclusive with origin\_direct, origin\_dns, origin\_port, proxy\_protocol, and argo\_smart\_routing. tls may only be “off” or “flexible”. Link to this property
proxy\_protocol: Optional\[Literal\["off", "v1", "v2", "simple"]] Enables Proxy Protocol to the origin. Refer to Enable Proxy protocol for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" Link to this property "v1" Link to this property "v2" Link to this property "simple" Link to this property
Link to this property
tls: Optional\[Literal\["off", "flexible", "full", "strict"]] The type of TLS termination associated with the application. One of the following: "off" Link to this property "flexible" Link to this property "full" Link to this property "strict" Link to this property
Link to this property virtual\_network\_id: Optional\[str] Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid Link to this property
Link to this property
class SpectrumConfigPaygoAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property
Link to this property
[Link to this property](<#(resource)%20spectrum.apps%20%3E%20(model)%20app_get_response%20%3E%20(schema)>)
AppCreateResponse One of the following:
class SpectrumConfigAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property
traffic\_type: Literal\["direct", "http", "https", "worker"] 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. When set to “worker”, traffic is sent to the Worker specified by origin_worker_id. One of the following: "direct" Link to this property "http" Link to this property "https" Link to this property "worker" Link to this property
Link to this property argo\_smart\_routing: Optional\[bool] Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. Link to this property edge\_ips: Optional\[EdgeIPs] The anycast edge IP configuration for the hostname of this application. Link to this property ip\_firewall: Optional\[bool] Enables IP Access Rules for this application. Notes: Only available for TCP applications. Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property origin\_dns: Optional\[OriginDNS] The name and type of DNS record for the Spectrum application. Link to this property origin\_port: Optional\[OriginPort] 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 Link to this property origin\_worker\_id: Optional\[str] Optional Worker script tag (worker ID) to use as the application’s origin. Only supported for TCP applications with traffic\_type “worker”; mutually exclusive with origin\_direct, origin\_dns, origin\_port, proxy\_protocol, and argo\_smart\_routing. tls may only be “off” or “flexible”. Link to this property
proxy\_protocol: Optional\[Literal\["off", "v1", "v2", "simple"]] Enables Proxy Protocol to the origin. Refer to Enable Proxy protocol for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" Link to this property "v1" Link to this property "v2" Link to this property "simple" Link to this property
Link to this property
tls: Optional\[Literal\["off", "flexible", "full", "strict"]] The type of TLS termination associated with the application. One of the following: "off" Link to this property "flexible" Link to this property "full" Link to this property "strict" Link to this property
Link to this property virtual\_network\_id: Optional\[str] Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid Link to this property
Link to this property
class SpectrumConfigPaygoAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property
Link to this property
[Link to this property](<#(resource)%20spectrum.apps%20%3E%20(model)%20app_create_response%20%3E%20(schema)>)
AppUpdateResponse One of the following:
class SpectrumConfigAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property
traffic\_type: Literal\["direct", "http", "https", "worker"] 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. When set to “worker”, traffic is sent to the Worker specified by origin_worker_id. One of the following: "direct" Link to this property "http" Link to this property "https" Link to this property "worker" Link to this property
Link to this property argo\_smart\_routing: Optional\[bool] Enables Argo Smart Routing for this application. Notes: Only available for TCP or UDP applications with traffic\_type set to “direct”. Link to this property edge\_ips: Optional\[EdgeIPs] The anycast edge IP configuration for the hostname of this application. Link to this property ip\_firewall: Optional\[bool] Enables IP Access Rules for this application. Notes: Only available for TCP applications. Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property origin\_dns: Optional\[OriginDNS] The name and type of DNS record for the Spectrum application. Link to this property origin\_port: Optional\[OriginPort] 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 Link to this property origin\_worker\_id: Optional\[str] Optional Worker script tag (worker ID) to use as the application’s origin. Only supported for TCP applications with traffic\_type “worker”; mutually exclusive with origin\_direct, origin\_dns, origin\_port, proxy\_protocol, and argo\_smart\_routing. tls may only be “off” or “flexible”. Link to this property
proxy\_protocol: Optional\[Literal\["off", "v1", "v2", "simple"]] Enables Proxy Protocol to the origin. Refer to Enable Proxy protocol for implementation details on PROXY Protocol V1, PROXY Protocol V2, and Simple Proxy Protocol. One of the following: "off" Link to this property "v1" Link to this property "v2" Link to this property "simple" Link to this property
Link to this property
tls: Optional\[Literal\["off", "flexible", "full", "strict"]] The type of TLS termination associated with the application. One of the following: "off" Link to this property "flexible" Link to this property "full" Link to this property "strict" Link to this property
Link to this property virtual\_network\_id: Optional\[str] Optional UUID of a virtual network for routing origin traffic through tunnel virtual networks. formatuuid Link to this property
Link to this property
class SpectrumConfigPaygoAppConfig: … id: str App identifier. maxLength32 Link to this property created\_on: datetime When the Application was created. formatdate-time Link to this property dns: DNS The name and type of DNS record for the Spectrum application. Link to this property modified\_on: datetime When the Application was last modified. formatdate-time Link to this property protocol: str 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". Link to this property origin\_direct: Optional\[List\[str]] List of origin IP addresses. Array may contain multiple IP addresses for load balancing. Link to this property
Link to this property
[Link to this property](<#(resource)%20spectrum.apps%20%3E%20(model)%20app_update_response%20%3E%20(schema)>)
class AppDeleteResponse: … id: str Identifier. maxLength32 Link to this property
[Link to this property](<#(resource)%20spectrum.apps%20%3E%20(model)%20app_delete_response%20%3E%20(schema)>)