---
title: Environments
---

[Skip to content](#%5Ftop) 

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

[Zones](https://developers.cloudflare.com/api/typescript/resources/zones)

Copy Markdown

Open in **Claude**

Open in **ChatGPT**

Open in **Cursor**

---

**Copy Markdown**

**View as Markdown**

# Environments

##### [List zone environments](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/environments/methods/list)

client.zones.environments.list(EnvironmentListParams { zone\_id } params, RequestOptionsoptions?): [EnvironmentListResponse](https://developers.cloudflare.com/api/typescript/resources/zones#%28resource%29%20zones.environments%20%3E%20%28model%29%20environment%5Flist%5Fresponse%20%3E%20%28schema%29) { environments } 

GET/zones/{zone\_id}/environments

##### [Create zone environments](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/environments/methods/create)

client.zones.environments.create(EnvironmentCreateParams { zone\_id, environments } params, RequestOptionsoptions?): [EnvironmentCreateResponse](https://developers.cloudflare.com/api/typescript/resources/zones#%28resource%29%20zones.environments%20%3E%20%28model%29%20environment%5Fcreate%5Fresponse%20%3E%20%28schema%29) { environments } 

POST/zones/{zone\_id}/environments

##### [Upsert zone environments](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/environments/methods/update)

client.zones.environments.update(EnvironmentUpdateParams { zone\_id, environments } params, RequestOptionsoptions?): [EnvironmentUpdateResponse](https://developers.cloudflare.com/api/typescript/resources/zones#%28resource%29%20zones.environments%20%3E%20%28model%29%20environment%5Fupdate%5Fresponse%20%3E%20%28schema%29) { environments } 

PUT/zones/{zone\_id}/environments

##### [Partially update zone environments](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/environments/methods/edit)

client.zones.environments.edit(EnvironmentEditParams { zone\_id, environments } params, RequestOptionsoptions?): [EnvironmentEditResponse](https://developers.cloudflare.com/api/typescript/resources/zones#%28resource%29%20zones.environments%20%3E%20%28model%29%20environment%5Fedit%5Fresponse%20%3E%20%28schema%29) { environments } 

PATCH/zones/{zone\_id}/environments

##### [Delete zone environment](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/environments/methods/delete)

client.zones.environments.delete(stringenvironmentID, EnvironmentDeleteParams { zone\_id } params, RequestOptionsoptions?): [EnvironmentDeleteResponse](https://developers.cloudflare.com/api/typescript/resources/zones#%28resource%29%20zones.environments%20%3E%20%28model%29%20environment%5Fdelete%5Fresponse%20%3E%20%28schema%29) { environments } 

DELETE/zones/{zone\_id}/environments/{environment\_id}

##### [Roll back zone environment](https://developers.cloudflare.com/api/typescript/resources/zones/subresources/environments/methods/rollback)

client.zones.environments.rollback(stringenvironmentID, EnvironmentRollbackParams { zone\_id } params, RequestOptionsoptions?): [EnvironmentRollbackResponse](https://developers.cloudflare.com/api/typescript/resources/zones#%28resource%29%20zones.environments%20%3E%20%28model%29%20environment%5Frollback%5Fresponse%20%3E%20%28schema%29) { environments } 

POST/zones/{zone\_id}/environments/{environment\_id}/rollback

##### ModelsExpand Collapse 

EnvironmentListResponse { environments } 

environments: Array<Environment\>

expression: string

locked\_on\_deployment: boolean | null

name: string

position: [ListCursor](https://developers.cloudflare.com/api/typescript/resources/rules#%28resource%29%20rules.lists.items%20%3E%20%28model%29%20list%5Fcursor%20%3E%20%28schema%29) { after, before } 

ref: string

version: number | null

formatint64

http\_application\_id?: string | null

EnvironmentCreateResponse { environments } 

environments: Array<Environment\>

expression: string

locked\_on\_deployment: boolean | null

name: string

position: [ListCursor](https://developers.cloudflare.com/api/typescript/resources/rules#%28resource%29%20rules.lists.items%20%3E%20%28model%29%20list%5Fcursor%20%3E%20%28schema%29) { after, before } 

ref: string

version: number | null

formatint64

http\_application\_id?: string | null

EnvironmentUpdateResponse { environments } 

environments: Array<Environment\>

expression: string

locked\_on\_deployment: boolean | null

name: string

position: [ListCursor](https://developers.cloudflare.com/api/typescript/resources/rules#%28resource%29%20rules.lists.items%20%3E%20%28model%29%20list%5Fcursor%20%3E%20%28schema%29) { after, before } 

ref: string

version: number | null

formatint64

http\_application\_id?: string | null

EnvironmentEditResponse { environments } 

environments: Array<Environment\>

expression: string

locked\_on\_deployment: boolean | null

name: string

position: [ListCursor](https://developers.cloudflare.com/api/typescript/resources/rules#%28resource%29%20rules.lists.items%20%3E%20%28model%29%20list%5Fcursor%20%3E%20%28schema%29) { after, before } 

ref: string

version: number | null

formatint64

http\_application\_id?: string | null

EnvironmentDeleteResponse { environments } 

environments: Array<Environment\>

expression: string

locked\_on\_deployment: boolean | null

name: string

position: [ListCursor](https://developers.cloudflare.com/api/typescript/resources/rules#%28resource%29%20rules.lists.items%20%3E%20%28model%29%20list%5Fcursor%20%3E%20%28schema%29) { after, before } 

ref: string

version: number | null

formatint64

http\_application\_id?: string | null

EnvironmentRollbackResponse { environments } 

environments: Array<Environment\>

expression: string

locked\_on\_deployment: boolean | null

name: string

position: [ListCursor](https://developers.cloudflare.com/api/typescript/resources/rules#%28resource%29%20rules.lists.items%20%3E%20%28model%29%20list%5Fcursor%20%3E%20%28schema%29) { after, before } 

ref: string

version: number | null

formatint64

http\_application\_id?: string | null