---
title: Update zone-level Waiting Room settings
---

[Skip to content](#_top)

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

[Waiting Rooms](https://developers.cloudflare.com/api/python/resources/waiting_rooms)

[Settings](https://developers.cloudflare.com/api/python/resources/waiting_rooms/subresources/settings)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Update zone-level Waiting Room settings

waiting\_rooms.settings.update(SettingUpdateParams\*\*kwargs) -> [SettingUpdateResponse](<https://developers.cloudflare.com/api/python/resources/waiting_rooms#(resource)%20waiting_rooms.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)>)

PUT/zones/{zone\_id}/waiting\_rooms/settings

Replace zone-level Waiting Room settings.

##### Security

<details>

<summary>API Token</summary>



The preferred authorization scheme for interacting with the Cloudflare API. <a href="https://developers.cloudflare.com/fundamentals/api/get-started/create-token/">Create a token</a>.

**Example:**<code>Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY</code>

</details>

<details>

<summary>API Email + API Key</summary>



The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

**Example:**<code>X-Auth-Email: user@example.com</code>

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

**Example:**<code>X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194</code>

</details>

##### Accepted Permissions (at least one required)

`Waiting Rooms Write`

##### ParametersExpand Collapse

zone\_id: str

Identifier.

maxLength32

[Link to this property](<#(resource)%20waiting_rooms.settings%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>)

search\_engine\_crawler\_bypass: Optional\[[bool](<https://developers.cloudflare.com/api/python/resources/waiting_rooms/subresources/settings/methods/update#(resource)%20waiting_rooms.settings%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20search_engine_crawler_bypass%20%3E%20(schema)>)]

Whether to allow verified search engine crawlers to bypass all waiting rooms on this zone. Verified search engine crawlers will not be tracked or counted by the waiting room system, and will not appear in waiting room analytics.

[Link to this property](<#(resource)%20waiting_rooms.settings%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20search_engine_crawler_bypass%20%3E%20(schema)>)

##### ReturnsExpand Collapse

<details>

<summary>

class SettingUpdateResponse: …

</summary>

search\_engine\_crawler\_bypass: bool

Whether to allow verified search engine crawlers to bypass all waiting rooms on this zone. Verified search engine crawlers will not be tracked or counted by the waiting room system, and will not appear in waiting room analytics.

<a href="#(resource)%20waiting_rooms.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)%20%3E%20(property)%20search_engine_crawler_bypass">Link to this property</a>

</details>

[Link to this property](<#(resource)%20waiting_rooms.settings%20%3E%20(model)%20setting_update_response%20%3E%20(schema)>)

### Update zone-level Waiting Room settings

Python

HTTPTypeScriptPythonGoTerraform

```
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
setting = client.waiting_rooms.settings.update(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
)
print(setting.search_engine_crawler_bypass)
```

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"
      }
    }
  ],
  "result": {
    "search_engine_crawler_bypass": true
  },
  "success": true
}
```

##### 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"
      }
    }
  ],
  "result": {
    "search_engine_crawler_bypass": true
  },
  "success": true
}
```