---
title: Apps
---

[Skip to content](#%5Ftop) 

[API Reference](https://developers.cloudflare.com/api/typescript)

[Magic Transit](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Apps

##### [List Apps](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit/subresources/apps/methods/list)

client.magicTransit.apps.list(AppListParams { account\_id } params, RequestOptionsoptions?): SinglePage<[AppListResponse](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit#%28resource%29%20magic%5Ftransit.apps%20%3E%20%28model%29%20app%5Flist%5Fresponse%20%3E%20%28schema%29)\>

GET/accounts/{account\_id}/magic/apps

##### [Create a new App](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit/subresources/apps/methods/create)

client.magicTransit.apps.create(AppCreateParams { account\_id, name, type, 3 more } params, RequestOptionsoptions?): [AppCreateResponse](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit#%28resource%29%20magic%5Ftransit.apps%20%3E%20%28model%29%20app%5Fcreate%5Fresponse%20%3E%20%28schema%29) { account\_app\_id, hostnames, ip\_subnets, 3 more } | null

POST/accounts/{account\_id}/magic/apps

##### [Update an App](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit/subresources/apps/methods/update)

client.magicTransit.apps.update(stringaccountAppID, AppUpdateParams { account\_id, hostnames, ip\_subnets, 3 more } params, RequestOptionsoptions?): [AppUpdateResponse](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit#%28resource%29%20magic%5Ftransit.apps%20%3E%20%28model%29%20app%5Fupdate%5Fresponse%20%3E%20%28schema%29) { account\_app\_id, hostnames, ip\_subnets, 3 more } | null

PUT/accounts/{account\_id}/magic/apps/{account\_app\_id}

##### [Update an App](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit/subresources/apps/methods/edit)

client.magicTransit.apps.edit(stringaccountAppID, AppEditParams { account\_id, hostnames, ip\_subnets, 3 more } params, RequestOptionsoptions?): [AppEditResponse](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit#%28resource%29%20magic%5Ftransit.apps%20%3E%20%28model%29%20app%5Fedit%5Fresponse%20%3E%20%28schema%29) { account\_app\_id, hostnames, ip\_subnets, 3 more } | null

PATCH/accounts/{account\_id}/magic/apps/{account\_app\_id}

##### [Delete Account App](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit/subresources/apps/methods/delete)

client.magicTransit.apps.delete(stringaccountAppID, AppDeleteParams { account\_id } params, RequestOptionsoptions?): [AppDeleteResponse](https://developers.cloudflare.com/api/typescript/resources/magic%5Ftransit#%28resource%29%20magic%5Ftransit.apps%20%3E%20%28model%29%20app%5Fdelete%5Fresponse%20%3E%20%28schema%29) { account\_app\_id, hostnames, ip\_subnets, 3 more } | null

DELETE/accounts/{account\_id}/magic/apps/{account\_app\_id}

##### ModelsExpand Collapse 

AppListResponse \= MagicAccountApp { account\_app\_id, hostnames, ip\_subnets, 3 more } | MagicManagedApp { managed\_app\_id, hostnames, ip\_subnets, 3 more } 

Collection of Hostnames and/or IP Subnets to associate with traffic decisions.

One of the following:

MagicAccountApp { account\_app\_id, hostnames, ip\_subnets, 3 more } 

Custom app defined for an account.

account\_app\_id: string

Magic account app ID.

hostnames?: Array<string\>

FQDNs to associate with traffic decisions.

ip\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

name?: string

Display name for the app.

source\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

type?: string

Category of the app.

MagicManagedApp { managed\_app\_id, hostnames, ip\_subnets, 3 more } 

Managed app defined by Cloudflare.

managed\_app\_id: string

Managed app ID.

hostnames?: Array<string\>

FQDNs to associate with traffic decisions.

ip\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

name?: string

Display name for the app.

source\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

type?: string

Category of the app.

AppCreateResponse { account\_app\_id, hostnames, ip\_subnets, 3 more } 

Custom app defined for an account.

account\_app\_id: string

Magic account app ID.

hostnames?: Array<string\>

FQDNs to associate with traffic decisions.

ip\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

name?: string

Display name for the app.

source\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

type?: string

Category of the app.

AppUpdateResponse { account\_app\_id, hostnames, ip\_subnets, 3 more } 

Custom app defined for an account.

account\_app\_id: string

Magic account app ID.

hostnames?: Array<string\>

FQDNs to associate with traffic decisions.

ip\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

name?: string

Display name for the app.

source\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

type?: string

Category of the app.

AppEditResponse { account\_app\_id, hostnames, ip\_subnets, 3 more } 

Custom app defined for an account.

account\_app\_id: string

Magic account app ID.

hostnames?: Array<string\>

FQDNs to associate with traffic decisions.

ip\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

name?: string

Display name for the app.

source\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

type?: string

Category of the app.

AppDeleteResponse { account\_app\_id, hostnames, ip\_subnets, 3 more } 

Custom app defined for an account.

account\_app\_id: string

Magic account app ID.

hostnames?: Array<string\>

FQDNs to associate with traffic decisions.

ip\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

name?: string

Display name for the app.

source\_subnets?: Array<string\>

IPv4 CIDRs to associate with traffic decisions. (IPv6 CIDRs are currently unsupported)

type?: string

Category of the app.