BunnyCDN

These are the BunnyCDN actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Add Storage Zone

  Tool to add a new storage zone. Use when you need dedicated file storage in a specific region. Zone creation is irreversible — confirm Name, Region, and ZoneTier before executing.

• Add/Update Edge Rule

  Tool to add or update edge rules in a BunnyCDN pull zone for advanced traffic control. Edge rules allow conditional request processing based on triggers like URL patterns, headers, country codes, or IP addresses. Each rule can perform actions like forcing SSL, redirecting, setting headers, overriding cache TTL, or blocking requests. Common use cases: - Force HTTPS: ActionType=force_ssl with URL trigger '/*' - Redirect old URLs: ActionType=redirect with specific URL pattern - Cache API responses: ActionType=override_cache_time for '/api/*' paths - Block specific countries: ActionType=block_request with country code trigger - Add security headers: ActionType=set_response_header for CORS/CSP headers To update an existing rule, provide the Guid from the creation response or from listing rules.

• Create Database

  Creates a new Bunny Database (SQLite-compatible edge database). The database can be deployed in multiple global edge regions with primary and replica configurations for high availability. Storage is available in EU (eu-west-1) or North America (us-east-1), and can be deployed across 41 global edge regions. Use when you need a distributed edge database with SQLite compatibility.

• Create DNS Record

  Tool to create a new DNS record in a specific DNS zone. Use after confirming the DNS zone ID is active.

• Create Pull Zone

  Creates a new CDN pull zone in BunnyCDN for content delivery acceleration. A pull zone acts as a CDN endpoint that caches and delivers content from your origin server through BunnyCDN's global edge network. When created, you get a default hostname (e.g., 'your-name.b-cdn.net') that can serve your content immediately. Use cases: - Accelerate website asset delivery (images, CSS, JS) - Stream video content globally - Cache and deliver API responses - Serve static files from S3 or storage zones Required: name (unique identifier) and origin_url (your source server). The name becomes part of your CDN URL: {name}.b-cdn.net

• Delete Database

  Tool to delete a BunnyCDN database by its ID. Use when you need to permanently remove an existing database after confirming the database ID.

• Delete Database Group

  Tool to delete a specific database group by its ID. Use when you need to remove a group from the database.

• Delete DNS Record

  Tool to delete a specific DNS record by its ID. Use after confirming the DNS zone ID and record ID.

• Delete DNS Zone

  Tool to delete a specific DNS zone by its ID. Use when you need to permanently remove an existing DNS zone after verifying the zone ID.

• Delete Pull Zone

  Tool to delete a specific pull zone by its ID. Use when you need to remove a pull zone after confirming its ID.

• Delete Storage Zone

  Tool to delete a storage zone. Deletion is irreversible — permanently removes the zone and all associated data. Use only after confirming the correct zone ID with the user.

• Get Billing Summary

  Tool to retrieve billing summary with data report for each Pull Zone. Use when you need to understand bandwidth usage and monthly charges across all pull zones.

• Get Database

  Tool to retrieve details of a specific database by its ID. Use when you need database configuration, size information, and region settings.

• Get DNS Zone List

  Tool to list all DNS zones in your Bunny CDN account. Use when you need an overview of all configured DNS zones.

• Get Pull Zone List

  Retrieve a paginated list of all Pull Zones in your BunnyCDN account. Use this to discover existing Pull Zones, their IDs, hostnames, and configuration. Supports filtering by name with the 'search' parameter and pagination with 'page' and 'per_page'. Returns pull zone details including hostnames, bandwidth usage, caching settings, and more.

• Get Shield Zone

  Tool to retrieve detailed configuration of a specific Shield Zone. Use when you need to view DDoS protection settings, WAF configuration, or security rules for a shield zone.

• Get Statistics

  Tool to retrieve CDN statistics data for bandwidth, requests, cache performance, and geographic distribution. Use this action to analyze CDN performance across pull zones or specific regions. Supports custom date ranges, hourly/daily grouping, and selective data loading for specific metrics.

• Get Storage Zone List

  Tool to list all storage zones in your Bunny CDN account. Use when you need an overview of all configured storage zones.

• Get User Details

  Tool to retrieve complete details of the currently authorized user account. Use when you need account information, billing status, or user profile data.

• List API Keys

  Tool to retrieve a paginated list of all API keys in your BunnyCDN account. Use when you need to view existing API keys and their associated roles.

• List Applications

  Tool to list all Magic Container applications in your Bunny CDN account. Use when you need an overview of deployed applications, their status, and endpoints. Supports cursor-based pagination for efficient traversal of large result sets.

• List Video Libraries

  Retrieve a paginated list of all video libraries in your BunnyCDN account. Use when you need to discover existing video libraries, their IDs, and configuration details.

• Reset Pull Zone Security Key

  Tool to reset the security token key for a specific pull zone. Use when you need to regenerate the security key for authentication purposes.

• Restore Database

  Tool to restore a BunnyCDN database to a specific generation/version. This is a destructive operation that will revert the database to the specified point in time. Use when you need to recover data from a previous version or undo unwanted changes. WARNING: This operation is destructive and will overwrite current database state.

• Update Database

  Tool to update an existing Bunny Database. Use when you need to change database name or control read/write access.

• Update Pull Zone

  Tool to update settings for a specific pull zone. Use when you need to modify existing pull zone settings after reviewing current configuration.

• Update Shield Zone

  Tool to update configuration settings for a Shield Zone. Use when you need to modify DDoS protection settings, WAF rules, or security configurations.

• Update Shield Zone Upload Scanning

  Tool to update upload scanning settings for a shield zone. Use when you need to configure antivirus and CSAM scanning for uploaded files.

• Update Storage Zone

  Tool to update settings for a specific storage zone. Updates are applied immediately and can destructively alter storage zone configuration. Verify the correct `id` and confirm intended changes before calling.

• Add Allowed Referer

  Adds a hostname to the allowed referer list for a pull zone. Use this action to restrict content access by configuring referer-based security. Only requests with a Referer header matching one of the allowed hostnames will be able to access the pull zone content. This helps prevent hotlinking and unauthorized content usage from other websites.

• Add Blocked IP

  Tool to add an IP address to the blocked list of a pull zone. Use when you need to restrict access from specific IPs to prevent unwanted traffic.

• Add Blocked Referer

  Tool to add a blocked referer to a pull zone. Use when you need to prevent specific domains from hotlinking or accessing content from your CDN.

• Check DNS Zone Availability

  Tool to check if a DNS zone name is available for registration. Use before creating a new DNS zone to verify the domain name is not already in use.

• Check Pull Zone Availability

  Tool to check if a pull zone name is available for registration. Use before creating a new pull zone to verify the name is not already in use.

• Check Storage Zone Availability

  Tool to check if a storage zone name is available. Use before creating a new storage zone to verify the name is not already in use.

• Create Coinify Payment

  Tool to create a Coinify cryptocurrency payment for BunnyCDN billing. Use when you need to add credit to a BunnyCDN account using cryptocurrency. Note: This endpoint is deprecated. Consider using alternative payment methods if available.

• Create Live Live 2

  Tool to retrieve live metrics data for database groups. Use when you need to fetch current performance metrics for specific group IDs.

• Create Shield Rate Limit

  Tool to create a new Shield rate limit rule for protecting against excessive requests. Use when you need to configure rate limiting rules to prevent abuse, DDoS attacks, or API overuse on a Shield zone.

• Create Shield Zone Access List

  Tool to create a new custom access list in a Shield Zone. Use when you need to add IP addresses, countries, ASNs, or JA3 fingerprints to control access.

• Delete Container Registry

  Tool to delete a container registry from Magic Containers. Use when you need to remove a container registry after confirming its ID.

• Delete Edge Rule

  Tool to delete an Edge Rule from a Pull Zone by its ID. Use when you need to remove an Edge Rule after confirming the Pull Zone ID and Edge Rule ID.

• Delete Shield Zone Access List

  Tool to delete a custom access list from a Shield Zone. Use when you need to remove an access control rule after confirming the Shield Zone ID and access list ID.

• Generate 2FA Verification

  Tool to generate 2FA verification details for account security setup. Use when setting up two-factor authentication for a BunnyCDN account.

• Generate Database Auth Token

  Tool to generate an authentication token for a BunnyCDN database. Use when you need to create access credentials for database operations.

• Get Coinify BTC Exchange Rate

  Tool to retrieve the current Coinify Bitcoin (BTC) exchange rate. Use when you need the current BTC price for cryptocurrency payment calculations. Note: This endpoint is deprecated according to the API documentation.

• Get Container Config Suggestions

  Tool to get AI-powered configuration suggestions for deploying a container image on BunnyCDN's Magic Containers platform. Use when you need deployment recommendations for a specific container image including endpoint configurations and environment variables.

• Get Container Image Digest

  Tool to retrieve the digest of a container image from a registry. Use when you need to verify an image version or pin to a specific digest.

• Get Database Group

  Tool to retrieve details of a specific database group by its ID. Use when you need to get configuration and region information for a database group.

• Get Database Limits

  Tool to retrieve current database limits for the authenticated BunnyCDN account. Use when you need to check database usage and capacity.

• Get Database Statistics

  Tool to retrieve time-series statistics for a Bunny Database instance. Returns hourly data for row read/write counts, delegated write requests, storage metrics, and latency over a specified date range. Use when you need to analyze database performance, usage patterns, or billing data.

• Get DNS Zone Details

  Tool to retrieve details of a specific DNS zone by its ID. Use when you need to verify DNS zone configuration after creation or update.

• Get Languages

  Tool to retrieve the list of languages supported by BunnyCDN's video library. Use when you need to discover available languages for player UI translation or automatic transcription features.

• Get oEmbed

  Tool to retrieve oEmbed metadata for BunnyCDN video embeds. Use when you need embed code or video metadata in oEmbed format.

• Get Optimal Base Region

  Tool to get the optimal base region for Magic Containers. Use when you need to determine the best region for deploying Magic Container instances based on current capacity and network conditions.

• Get Optimizer Statistics

  Retrieve optimizer statistics for a Pull Zone to understand optimization performance. Use this action to analyze how Bunny Optimizer is performing for a specific Pull Zone, including compression ratios, processing times, optimized request counts, and traffic savings. Supports custom date ranges and hourly/daily grouping for detailed analysis.

• Get Origin Shield Queue Statistics

  Tool to retrieve Origin Shield Queue Statistics for a specific Pull Zone. Use when you need to analyze Origin Shield performance metrics including concurrent and queued request data over a specified time period.

• Get Prepare Payment Authorization

  Tool to prepare payment authorization for Bunny CDN billing. Use when you need to obtain an authorization key for payment processing. Note: This endpoint is deprecated.

• Get Pull Zone

  Tool to retrieve details of a specific Pull Zone. Use when you need full configuration and usage stats after confirming the Pull Zone ID.

• Get SafeHop Statistics

  Tool to retrieve SafeHop statistics for a specific Pull Zone. Use when you need to analyze how SafeHop has improved reliability by retrying and saving requests. SafeHop is BunnyCDN's feature that automatically retries failed requests and saves bandwidth by serving stale content when the origin is unavailable.

• Get Shield Bot Detection Configuration

  Tool to retrieve bot detection configuration for a specific Shield Zone. Use when you need to view the current bot detection settings and sensitivity levels.

• Get Shield DDoS Enums

  Tool to retrieve available enums for Shield DDoS configuration. Use when you need to discover valid values for DDoS protection settings.

• Get Shield Event Logs

  Tool to retrieve Shield Event Logs for a specific Shield Zone and date. Use when you need to view security events and Shield activity logs. Supports pagination via continuation tokens for large log sets.

• Get Shield Metrics Bot Detection

  Tool to retrieve bot detection metrics for a specific Shield Zone. Use when you need to analyze bot traffic and challenges for a Shield Zone.

• Get Shield Metrics Overview

  Tool to retrieve comprehensive security metrics overview for a Shield Zone. Use when you need statistics on DDoS protection, WAF rules, bot detection, rate limiting, access lists, and upload scanning for a specific Shield Zone.

• Get Shield Metrics Overview Detailed

  Tool to retrieve detailed Shield zone metrics overview including DDoS protection, WAF, bot detection, rate limiting, access lists, and upload scanning statistics. Use when you need comprehensive protection metrics for a specific Shield zone over a time period.

• Get Shield Metrics Rate Limit by ID

  Tool to retrieve shield metrics for a specific rate limit by ID. Use when you need to monitor rate limit breach statistics and analyze traffic patterns over the past 28 days.

• Get Shield Metrics Rate Limits

  Tool to retrieve rate limit metrics for a Shield Zone. Use when you need to analyze rate limiting patterns and statistics for DDoS protection.

• Get Shield Metrics Upload Scanning

  Tool to retrieve upload scanning metrics for a specific Shield Zone. Use when you need to analyze file upload security and scanning statistics for a Shield Zone.

• Get Shield Metrics WAF Rule

  Tool to retrieve shield metrics for a specific WAF rule. Use when you need to analyze how many requests were blocked, challenged, or logged by a particular WAF rule within a Shield Zone.

• Get Shield Promo State

  Tool to retrieve a breakdown of Shield promotional data. Use when you need information about current, eligible, and enrolled Shield promotions.

• Get Shield Rate Limit by ID

  Tool to retrieve a specific rate limit configuration by its ID. Use when you need to view the full details and settings of a shield rate limit rule.

• Get Shield Rate Limits

  Tool to retrieve Shield Rate Limits for a specific Shield Zone. Use when you need to list or audit rate limiting rules configured for a Shield Zone.

• Get Shield Shield Zones

  Tool to retrieve a list of all Shield Zones with their configurations. Use when you need to view all Shield Zones and their security settings. Supports pagination to handle large numbers of Shield Zones.

• Get Shield Upload Scanning Configuration

  Tool to retrieve upload scanning configuration for a Shield Zone. Use when you need to check antivirus and CSAM scanning settings for uploaded files.

• Get Shield WAF Custom Rule by ID

  Tool to retrieve details of a specific Shield WAF custom rule by its ID. Use when you need to view the configuration, conditions, and actions of a custom Web Application Firewall rule.

• Get Shield WAF Custom Rules

  Tool to retrieve custom WAF rules for a specific Shield Zone. Use when you need to list or review custom WAF rule configurations. Supports pagination for large rule sets.

• Get Shield WAF Engine Config

  Tool to retrieve Shield WAF engine configuration settings. Use when you need to view the current WAF engine configuration parameters and their values.

• Get Shield WAF Enums

  Tool to retrieve available enums for Shield WAF configuration. Use when you need to discover valid values for WAF protection settings.

• Get Shield WAF Profiles

  Tool to retrieve available WAF profiles for Shield zones. Use when you need to list all available WAF security profiles including their features, categories, and descriptions.

• Get Shield WAF Rules by Shield Zone ID

  Tool to retrieve Shield WAF Rules for a specific Shield Zone. Use when you need to view or audit the WAF rule configurations applied to a Shield Zone.

• Get Shield WAF Rules Plan Segmentation

  Tool to retrieve WAF rules organized by subscription plan tiers. Use when you need to understand which WAF rules are available for different Shield plan levels.

• Get Shield WAF Rules Review Triggered

  Tool to retrieve triggered WAF rules for review in a specific Shield Zone. Use when you need to analyze which WAF rules have been triggered and review security events for remediation.

• Get Shield Zone Access List

  Tool to retrieve a specific custom access list from a Shield Zone. Use when you need to view details of an access control rule including its content, type, and metadata.

• Get Shield Zone Access List Enums

  Tool to retrieve available enums for Shield Zone Access List configuration. Use when you need to discover valid values for access list settings for a specific Shield Zone.

• Get Shield Zone Access Lists

  Tool to retrieve all access lists for a Shield Zone, including both managed threat lists and custom lists. Use when you need to view access control configurations and their status.

• Get Shield Zone by Pull Zone ID

  Tool to retrieve Shield Zone details by Pull Zone ID. Use when you need to view security and protection settings for a specific Pull Zone. Returns DDoS protection, WAF configuration, and other Shield settings.

• Get Shield Zones Pull Zone Mapping

  Tool to retrieve the mapping between Shield Zones and Pull Zones. Use when you need to see which Shield Zones are protecting which Pull Zones in your BunnyCDN account.

• Get Storage Zone Details

  Tool to retrieve the full details of a storage zone, including configuration, usage metrics, and credentials. The response includes sensitive fields Password and ReadOnlyPassword — mask or omit these from logs and user-facing output.

• Get User Audit Log

  Tool to retrieve user audit log entries for a specific date with optional filtering. Use when you need to track user actions, security auditing, or compliance reporting.

• Get User Limits

  Tool to retrieve user limits and quotas for Magic Containers. Use when you need to check application, instance, region, and volume limits for the authenticated account.

• Get What's New Items

  Tool to retrieve What's New items for the current user. Use when you need to discover recent features, updates, and bug fixes in the BunnyCDN platform.

• Invalidate Database Auth Tokens

  Tool to invalidate all authentication tokens for a BunnyCDN database. Use when you need to revoke all active access credentials for a specific database.

• Invalidate Group Auth Tokens

  Tool to invalidate authentication tokens for a specific database group. Use when you need to revoke all active tokens for a group.

• List Container Image Tags

  Tool to list all available tags for a container image in a registry. Use when you need to discover available versions or tags for a container image.

• List Container Registries

  Tool to list all container registries in your BunnyCDN Magic Containers account. Use when you need to view configured container registries with their connection details.

• List Country List

  Tool to retrieve the list of countries supported by BunnyCDN with their tax rates and Points of Presence. Use when you need to discover available countries, their tax information, or PoP locations for billing and geographic routing purposes.

• List Database Active Usage

  Tool to retrieve active database usage statistics. Returns the number of active databases, total databases, and total size across all databases. Use when you need an overview of database usage and storage allocation.

• List Database Configuration

  Tool to retrieve database configuration including available storage regions, primary regions, and replica regions. Use when you need to discover which regions are available for database deployment and replication.

• List Database Group Usage

  Tool to retrieve aggregated usage statistics for a database group over a specified time period. Returns total rows read/written and average latency. Use when you need to analyze group-level usage patterns or billing data.

• List Database Groups

  Tool to retrieve a list of all database groups in your BunnyCDN account. Use when you need to discover existing database groups and their configuration.

• List Database Usage

  Tool to retrieve aggregated usage metrics for a Bunny Database instance. Returns total rows read/written and average latency for a specified date range. Use when you need aggregated usage statistics rather than time-series data.

• List Database Versions

  Tool to list all versions of a specific database. Use when you need to view version history, track database changes, or restore to a previous version.

• List Databases V2

  Tool to list databases with pagination support using the v2 API. Use when you need to paginate through large numbers of databases or need pagination metadata.

• List Edge Scripts

  Retrieve a paginated list of all edge scripts in your BunnyCDN account. Use when you need to discover existing edge scripts, their IDs, types, and configuration.

• List Group Statistics

  Tool to retrieve time-series statistics for a database group. Returns data for row read/write counts and storage usage over a specified date range. Use when you need to analyze group-level performance, usage patterns, or billing data.

• List Nodes

  Tool to retrieve a list of Magic Container nodes in your BunnyCDN account. Use when you need to view available node IP addresses for Magic Containers. Supports pagination through cursor-based navigation.

• List Notifications

  Tool to list all notifications for the currently logged in user. Use when you need to retrieve notifications.

• List Region List

  Tool to retrieve the list of regions supported by BunnyCDN with their geographic coordinates and pricing. Use when you need to discover available regions for deployment or to get pricing information per region.

• List Regions

  Tool to list all available regions for Magic Containers. Use when you need to discover available deployment regions, check their capacity status, or understand Anycast support across regions.

• List Volumes

  Tool to list all volumes for a Magic Container application in your BunnyCDN account. Use when you need to view storage volumes, their capacity, usage, and attached instances for a specific app.

• Post Shield WAF Rules Review Triggered

  Tool to review and apply actions to triggered WAF rules in a specific Shield Zone. Use when you need to whitelist, block, or challenge specific WAF rules based on their triggered status.

• Purge Pull Zone

  Purges the entire CDN cache for a specified pull zone. Use this action after updating content at the origin server to ensure that stale cached assets are cleared and fresh content is served to end users. This operation invalidates all cached files across all edge servers for the specified pull zone. Note that this does not affect Perma-Cache content.

• Purge URL

  Purge a specific URL from the BunnyCDN cache to force it to be refreshed from the origin. Use this tool when you need to: - Invalidate cached content after updating a file on the origin server - Force immediate cache refresh for a specific resource - Clear outdated content from edge servers Note: The URL must belong to a pull zone you have access to. Attempting to purge URLs from pull zones you don't own will result in an authorization error.

• Remove Allowed Referer

  Removes a hostname from the allowed referer list for a pull zone. Use this action to remove a previously configured referer-based security restriction. After removal, the specified hostname will no longer be allowed to access the pull zone content. This is useful when updating referer security policies or removing domains that should no longer have access.

• Remove Blocked IP

  Tool to remove an IP address from the blocked list of a pull zone. Use when you need to restore access for specific IPs that were previously blocked.

• Remove Blocked Referer

  Tool to remove a blocked referer from a pull zone. Use when you need to allow a previously blocked domain to access content from your CDN again.

• Reset What's New

  Tool to reset the What's New notification list for the current user. Use when you need to mark all What's New items as read and reset the unread count.

• Search Global Search

  Perform a global search across all BunnyCDN resources (pull zones, storage zones, DNS zones, scripts, streams). Use this to discover resources by name across your entire BunnyCDN account. Supports pagination with 'from' and 'size' parameters. Returns matching resources with their type, ID, and name for easy identification.

• Search Public Container Images

  Tool to search for public container images by prefix in a registry. Use when you need to discover available public container images matching a search term.

• Set Edge Rule Enabled

  Tool to enable or disable an edge rule in a BunnyCDN pull zone. Use when you need to activate or deactivate an existing edge rule without modifying its configuration. Edge rules that are disabled remain configured but do not execute. This allows you to temporarily turn off rules without deleting them. Common use cases: temporarily disable security rules for testing, enable/disable seasonal redirects, or toggle feature flags implemented as edge rules.

• Set Force SSL

  Tool to set Force SSL on a pull zone hostname. Use when you need to enable or disable HTTPS enforcement for a specific hostname.

• Set Notifications Opened

  Tool to mark all user notifications as opened. Use when you need to clear unread notification indicators. Returns success once notifications are marked as read.

• Update Database Group

  Tool to update a database group by its ID. Use when you need to modify the name or configuration of a database group.

• Update Shield Bot Detection Configuration

  Tool to update bot detection configuration for a specific Shield Zone. Use when you need to modify bot detection settings, sensitivity levels, or execution mode. Note: Bot detection requires Advanced tier subscription.

• Update Shield Rate Limit by ID

  Tool to update a specific rate limit configuration by its ID. Use when you need to modify settings of an existing shield rate limit rule such as request thresholds, timeframes, or action types.

• Update Shield Zone Access List

  Tool to update a custom access list in a Shield Zone. Use when you need to modify an access control rule's name, content, or checksum.

• Update Shield Zone Access List Configuration

  Tool to update an access list configuration in a Shield Zone. Use when you need to modify the action or enabled state of an existing access list configuration.

• Update User Details

  Tool to update the currently authorized user's account details. Use when modifying user profile information, billing details, or email preferences.

• Validate Origin URL Pull Zone

  Tool to validate an origin URL before creating or configuring a pull zone. Use when you need to verify that an origin URL is accessible and properly configured for use with BunnyCDN.