# Settings

## Get zone-level Waiting Room settings

`waiting_rooms.settings.get(SettingGetParams**kwargs)  -> SettingGetResponse`

**get** `/zones/{zone_id}/waiting_rooms/settings`

Gets the zone-level Waiting Room settings that apply as defaults to all waiting rooms on the zone.

### Parameters

- `zone_id: str`

  Identifier.

### Returns

- `class SettingGetResponse: …`

  - `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.

### Example

```python
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.get(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
)
print(setting.search_engine_crawler_bypass)
```

#### Response

```json
{
  "result": {
    "search_engine_crawler_bypass": true
  }
}
```

## Update zone-level Waiting Room settings

`waiting_rooms.settings.update(SettingUpdateParams**kwargs)  -> SettingUpdateResponse`

**put** `/zones/{zone_id}/waiting_rooms/settings`

Fully updates zone-level Waiting Room settings, replacing the existing configuration.

### Parameters

- `zone_id: str`

  Identifier.

- `search_engine_crawler_bypass: Optional[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.

### Returns

- `class SettingUpdateResponse: …`

  - `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.

### Example

```python
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)
```

#### Response

```json
{
  "result": {
    "search_engine_crawler_bypass": true
  }
}
```

## Patch zone-level Waiting Room settings

`waiting_rooms.settings.edit(SettingEditParams**kwargs)  -> SettingEditResponse`

**patch** `/zones/{zone_id}/waiting_rooms/settings`

Partially updates zone-level Waiting Room settings using PATCH semantics.

### Parameters

- `zone_id: str`

  Identifier.

- `search_engine_crawler_bypass: Optional[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.

### Returns

- `class SettingEditResponse: …`

  - `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.

### Example

```python
import os
from cloudflare import Cloudflare

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

#### Response

```json
{
  "result": {
    "search_engine_crawler_bypass": true
  }
}
```

## Domain Types

### Setting

- `class Setting: …`

  - `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.

### Setting Get Response

- `class SettingGetResponse: …`

  - `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.

### Setting Update Response

- `class SettingUpdateResponse: …`

  - `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.

### Setting Edit Response

- `class SettingEditResponse: …`

  - `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.