Cloudflare Docs
Waiting Room
Visit Waiting Room on GitHub
Set theme to dark (⇧+D)

API commands

Cloudflare Waiting Room redirect visitors to virtual waiting rooms when they are trying to access web pages that have high volumes of traffic.

The Cloudflare Waiting Room API provides an interface for programmatically managing waiting rooms.

​​ Request URL format

To invoke a Cloudflare Waiting Room API operation, append the endpoint to the Cloudflare API base URL:


https://api.cloudflare.com/client/v4

For authentication instructions, refer to Getting Started: Requests in the Cloudflare API documentation.

For help with endpoints and pagination, refer to Getting Started: Endpoints.

​​ Manage your waiting room

Operation Method + URL stub Notes
List waiting rooms GET zones/{:zone_identifier}/waiting_rooms List all waiting rooms for a zone.
Create waiting room POST zones/{:zone_identifier}/waiting_rooms Create a waiting room.
Waiting room details GET zones/{:zone_identifier}/waiting_rooms/{:identifier} Fetch a waiting room.
Update waiting room PUT zones/{:zone_identifier}/waiting_rooms/{:identifier} Update a waiting room.
Delete waiting room DELETE zones/{:zone_identifier}/waiting_rooms/{:identifier} Delete a waiting room.
Patch waiting room PATCH zones/{:zone_identifier}/waiting_rooms/{:identifier} Patch a configured waiting room.

​​ Fetch the current status of a waiting room

Operation Method + URL stub Notes
Get the current status of a waiting room GET zones/{:zone_identifier}/waiting_rooms/{:identifier}/status
  • Returns queueing if the queue is activated (clients are put in the waiting room).
  • Returns not_queueing if the queue is not activated or if the waiting room is suspended.