Bunnycdn Add Update Edge Rule

The unique GUID of the edge rule. Provide this to update an existing rule. Leave empty to create a new rule. The API returns this GUID when creating a rule.

Whether the edge rule is currently active. Set to true to enable the rule immediately, false to create it in disabled state.

Whether the edge rule is read-only and cannot be modified or deleted. Typically used for system-generated rules.

List of trigger conditions that determine when this edge rule executes. At least one trigger is required. Common use: URL trigger with pattern '/*' matches all requests.

The main action type of the edge rule. Common values: force_ssl (redirect HTTP to HTTPS), redirect (URL redirects), block_request (block access), set_response_header (add/modify response headers), override_cache_time (set cache TTL). See the ActionType enum for all 17 supported…

Execution priority order. Lower numbers execute first. Use this to control the sequence of multiple edge rules. If not specified, the rule is added at the end.

Human-readable description of what this edge rule does. Helps identify the rule's purpose when managing multiple rules.

Additional actions to execute when the edge rule triggers. Allows combining multiple actions (e.g., set header AND override cache time) in one rule.

The ID of the Pull Zone where the Edge Rule will be created or updated. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.

First action parameter. Meaning depends on ActionType: for redirect = destination URL, for set_response_header = header name, for override_cache_time = TTL in seconds, for set_status_code = status code (e.g., '404').

Second action parameter. Meaning depends on ActionType: for redirect = redirect type ('301' or '302'), for set_response_header = header value.

Third action parameter. Meaning depends on ActionType. Rarely used, reserved for future action types.