BunnyCDN
CDN and edge storage platform for pull zones, storage zones, files, purge jobs, and traffic metrics.
Supports CDN and edge-storage work across pull zones, storage zones, files, purges, and traffic metrics.
Example Use Cases
These are the BunnyCDN actions Snow can use when building apps with you. Connecting an account does not make Snow run these on its own.
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.
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.
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.
Tool to create a new DNS record in a specific DNS zone. Use after confirming the DNS zone ID is active.
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
Tool to delete a BunnyCDN database by its ID. Use when you need to permanently remove an existing database after confirming the database ID.
Tool to delete a specific database group by its ID. Use when you need to remove a group from the database.
Tool to delete a specific DNS record by its ID. Use after confirming the DNS zone ID and record ID.
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.
Tool to delete a specific pull zone by its ID. Use when you need to remove a pull zone after confirming its ID.
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.
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.
Tool to retrieve details of a specific database by its ID. Use when you need database configuration, size information, and region settings.
Tool to list all DNS zones in your Bunny CDN account. Use when you need an overview of all configured DNS zones.
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.
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.
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.
Tool to list all storage zones in your Bunny CDN account. Use when you need an overview of all configured storage zones.
Tool to retrieve complete details of the currently authorized user account. Use when you need account information, billing status, or user profile data.
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.
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.
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.
Tool to reset the security token key for a specific pull zone. Use when you need to regenerate the security key for authentication purposes.
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.
Tool to update an existing Bunny Database. Use when you need to change database name or control read/write access.
Tool to update settings for a specific pull zone. Use when you need to modify existing pull zone settings after reviewing current configuration.
Tool to update configuration settings for a Shield Zone. Use when you need to modify DDoS protection settings, WAF rules, or security configurations.
Tool to update upload scanning settings for a shield zone. Use when you need to configure antivirus and CSAM scanning for uploaded files.
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.
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.
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.
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.
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.
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.
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.
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.
Tool to retrieve live metrics data for database groups. Use when you need to fetch current performance metrics for specific group IDs.
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.
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.
Tool to delete a container registry from Magic Containers. Use when you need to remove a container registry after confirming its ID.
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.
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.
Tool to generate 2FA verification details for account security setup. Use when setting up two-factor authentication for a BunnyCDN account.
Tool to generate an authentication token for a BunnyCDN database. Use when you need to create access credentials for database operations.
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.
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.
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.
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.
Tool to retrieve current database limits for the authenticated BunnyCDN account. Use when you need to check database usage and capacity.
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.
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.
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.
Tool to retrieve oEmbed metadata for BunnyCDN video embeds. Use when you need embed code or video metadata in oEmbed format.
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.
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.
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.
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.
Tool to retrieve details of a specific Pull Zone. Use when you need full configuration and usage stats after confirming the Pull Zone ID.
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.
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.
Tool to retrieve available enums for Shield DDoS configuration. Use when you need to discover valid values for DDoS protection settings.
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.
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.
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.
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.
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.
Tool to retrieve rate limit metrics for a Shield Zone. Use when you need to analyze rate limiting patterns and statistics for DDoS protection.
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.
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.
Tool to retrieve a breakdown of Shield promotional data. Use when you need information about current, eligible, and enrolled Shield promotions.
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.
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.
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.
Tool to retrieve upload scanning configuration for a Shield Zone. Use when you need to check antivirus and CSAM scanning settings for uploaded files.
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.
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.
Tool to retrieve Shield WAF engine configuration settings. Use when you need to view the current WAF engine configuration parameters and their values.
Tool to retrieve available enums for Shield WAF configuration. Use when you need to discover valid values for WAF protection settings.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Tool to invalidate all authentication tokens for a BunnyCDN database. Use when you need to revoke all active access credentials for a specific database.
Tool to invalidate authentication tokens for a specific database group. Use when you need to revoke all active tokens for a group.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Tool to list all notifications for the currently logged in user. Use when you need to retrieve notifications.
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.
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.
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.
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.
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 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.
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.
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.
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.
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.
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.
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.
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.
Tool to set Force SSL on a pull zone hostname. Use when you need to enable or disable HTTPS enforcement for a specific hostname.
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.
Tool to update a database group by its ID. Use when you need to modify the name or configuration of a database group.
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.
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.
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.
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.
Tool to update the currently authorized user's account details. Use when modifying user profile information, billing details, or email preferences.
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.