--- title: Update Zero Trust list --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Zero Trust](https://developers.cloudflare.com/api/typescript/resources/zero_trust) [Gateway](https://developers.cloudflare.com/api/typescript/resources/zero_trust/subresources/gateway) [Lists](https://developers.cloudflare.com/api/typescript/resources/zero_trust/subresources/gateway/subresources/lists) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update Zero Trust list client.zeroTrust.gateway.lists.update(stringlistID, ListUpdateParams {account\_id, name, description, items } params, RequestOptionsoptions?): [GatewayList]() {id, count, created\_at, 5 more } PUT/accounts/{account\_id}/gateway/lists/{list\_id} Updates a configured Zero Trust list. Skips updating list items if not included in the payload. A non empty list items will overwrite the existing list. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### ParametersExpand Collapse listID: string Identify the API resource with a UUID. maxLength36 [Link to this property](<#(resource)%20zero_trust.gateway.lists%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20list_id%20%3E%20(schema)>)
params: ListUpdateParams {account\_id, name, description, items } account\_id: string Path param: Specify the Cloudflare account identifier. Link to this property name: string Body param: Specify the list name. Link to this property description?: string Body param: Provide the list description. Link to this property
items?: Array<Item> Body param: Add items to the list. description?: string Provide the list item description (optional). minimum0 Link to this property value?: string Specify the item value. Link to this property
Link to this property
[Link to this property](<#(resource)%20zero_trust.gateway.lists%20%3E%20(method)%20update%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
GatewayList {id, count, created\_at, 5 more } id?: string Identify the API resource with a UUID. maxLength36 Link to this property count?: number Indicate the number of items in the list. Link to this property created\_at?: string formatdate-time Link to this property description?: string Provide the list description. Link to this property
items?: Array<GatewayItem {created\_at, description, value } > Provide the list items. created\_at?: string formatdate-time Link to this property description?: string Provide the list item description (optional). minimum0 Link to this property value?: string Specify the item value. Link to this property
Link to this property name?: string Specify the list name. Link to this property
type?: "SERIAL"| "URL"| "DOMAIN"| 6 more Specify the list type. One of the following: "SERIAL" Link to this property "URL" Link to this property "DOMAIN" Link to this property "EMAIL" Link to this property "IP" Link to this property "CATEGORY" Link to this property "LOCATION" Link to this property "DEVICE" Link to this property "AAGUID" Link to this property
Link to this property updated\_at?: string formatdate-time Link to this property
[Link to this property](<#(resource)%20zero_trust.gateway.lists%20%3E%20(model)%20gateway_list%20%3E%20(schema)>) ### Update Zero Trust list TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const gatewayList = await client.zeroTrust.gateway.lists.update( 'f174e90a-fafe-4643-bbbc-4a0ed4fc8415', { account_id: '699d98642c564d2e855e9661899b7252', name: 'Admin Serial Numbers' }, ); console.log(gatewayList.id); ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "count": 20, "created_at": "2014-01-01T05:20:00.12345Z", "description": "The serial numbers for administrators", "items": [ { "created_at": "2014-01-01T05:20:00.12345Z", "description": "Austin office IP", "value": "8GE8721REF" } ], "name": "Admin Serial Numbers", "type": "SERIAL", "updated_at": "2014-01-01T05:20:00.12345Z" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "count": 20, "created_at": "2014-01-01T05:20:00.12345Z", "description": "The serial numbers for administrators", "items": [ { "created_at": "2014-01-01T05:20:00.12345Z", "description": "Austin office IP", "value": "8GE8721REF" } ], "name": "Admin Serial Numbers", "type": "SERIAL", "updated_at": "2014-01-01T05:20:00.12345Z" } } ```