Skip to content
Cloudflare Docs

Edit and delete waiting rooms

You can manage your waiting rooms using the Waiting Room dashboard or the API.

Use the dashboard

Edit a waiting room

  1. In your application, go to Traffic > Waiting Room.
  2. On a record, select Edit.
  3. Select Settings.
  4. Edit the settings. For a description of settings, refer to Configuration settings.
  5. Select Next. If you have access to customized templates, you could also adjust the template.
  6. Once you get to Review, select Save.

Delete a waiting room

  1. In your application, go to Traffic > Waiting Room.
  2. On a record, select Delete.
  3. Select Delete again.

Use the API

Edit a waiting room

Replace ↗ a configured waiting room by appending the following endpoint to the Cloudflare API base URL.

Required API token permissions

 At least one of the following token permissions is required:
  • Waiting Rooms Write
Update waiting room
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms/$WAITING_ROOM_ID" \
  --request PUT \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --json '{
    "name": "webshop-waiting-room",
    "host": "example.com",
    "new_users_per_minute": 200,
    "total_active_users": 300
  }'

Update ↗ a configured waiting room by appending the following endpoint to the Cloudflare API base URL.

Required API token permissions

 At least one of the following token permissions is required:
  • Waiting Rooms Write
Patch waiting room
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms/$WAITING_ROOM_ID" \
  --request PATCH \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --json '{
    "name": "webshop-waiting-room",
    "host": "example.com",
    "new_users_per_minute": 200,
    "total_active_users": 300
  }'

You only need to include the fields you want to update in the payload of the PATCH request.

Delete a waiting room

Delete a waiting room by appending the following endpoint in the Waiting Room API ↗ to the Cloudflare API base URL.

Required API token permissions

 At least one of the following token permissions is required:
  • Waiting Rooms Write
Delete waiting room
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms/$WAITING_ROOM_ID" \
  --request DELETE \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"