BunnyCDN is a powerful content delivery network (CDN) offering an API to manage and deliver content globally with ease.
BunnyCDN is a powerful content delivery network (CDN) offering an API to manage and deliver content globally with ease. On Nagent, BunnyCDN is exposed as a fully-configurable developer tools integration that any agent can call — 129 actions, and API key authentication. No code is required to wire BunnyCDN into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use BunnyCDN to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire BunnyCDN into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against BunnyCDN, with input parameters and output schema. Drop these into any step of an agent built in Helix.
BUNNYCDN_ADD_ALLOWED_REFERERAdds 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.
Input parameters
The ID of the pull zone to which the allowed referer will be added. Use the 'Get Pull Zone List' action to find available pull zone IDs.
The hostname that will be added as an allowed referer. This restricts content access to requests coming from this specific domain (e.g., 'example.com', 'www.mysite.com').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_ADD_BLOCKED_IPTool 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.
Input parameters
The ID of the Pull Zone to which the IP will be blocked. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.
The IP address that will be blocked from accessing the pull zone. Supports IPv4 and IPv6 formats.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_ADD_BLOCKED_REFERERTool 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.
Input parameters
The ID of the pull zone to which the blocked referer will be added. Use the 'Get Pull Zone List' action to find available pull zone IDs.
The hostname that will be added as a blocked referer. Requests with this referer will be blocked from accessing the pull zone content.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_ADD_STORAGE_ZONETool 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.
Input parameters
Name of the storage zone to be created. Must be unique and can contain alphanumeric characters and hyphens.
Primary region for the storage zone. Allowed values: DE (Germany), NY (New York), LA (Los Angeles), SG (Singapore).
Storage tier. 0 = Standard (default), 1 = Edge (for edge storage).
Backup data source URL. If a file is missing in the storage zone, BunnyCDN will try to fetch it from this URL.
List of additional regions for replicating the storage zone data. Allowed values: DE, NY, LA, SG, SYD (Sydney). Cannot include the primary region.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_ADD_UPDATE_EDGE_RULETool 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.
Input parameters
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 action types.
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.
How multiple triggers are combined. MatchAny (match_any) = rule executes if ANY trigger matches, MatchAll (match_all) = ALL triggers must match, MatchNone (match_none) = rule executes if NO triggers match.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CHECK_DNS_ZONE_AVAILABILITYTool 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.
Input parameters
The domain name to check for DNS zone availability (e.g., 'example.com').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CHECK_PULL_ZONE_AVAILABILITYTool 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.
Input parameters
The pull zone name to check for availability. This will be used as the subdomain (e.g., 'my-zone' becomes 'my-zone.b-cdn.net').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CHECK_STORAGE_ZONE_AVAILABILITYTool 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.
Input parameters
The storage zone name to check for availability. Must be unique and can contain alphanumeric characters and hyphens.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CREATE_COINIFY_PAYMENTTool 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.
Input parameters
The amount to charge in USD. Must be a positive number (e.g., 10.00, 50.25).
Optional payment request ID to associate with this payment. Use this to track or link the payment to an existing request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CREATE_DATABASECreates 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.
Input parameters
The name of the database to create. Must be unique within your account.
Storage region for the database. 'eu-west-1' for Europe or 'us-east-1' for North America.
Array of primary region codes where the database will be deployed. Valid region codes include: AMS, ASB, AT, BE, BO, BR, BU, CA, CO, CZ, DE, DEN, DK, ES, FR, GA, GR, HK, HR, ID, IL, ISR, IT, JH, JP, LA, MI, MX, MY, NG, NY, PH, PL, SE, SG, SIL, SYD, TH, TR, TX, UK, WA.
Array of replica region codes for read replicas. Can be an empty array if no replicas are needed. Uses same region codes as primary_regions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CREATE_DNS_RECORDTool to create a new DNS record in a specific DNS zone. Use after confirming the DNS zone ID is active.
Input parameters
Tag for CAA records.
Time to live for the record in seconds.
The record name (e.g., 'www' for 'www.example.com').
Port number for SRV records.
Type of DNS record. 0=A,1=AAAA,2=CNAME,3=TXT,4=MX,5=Redirect,6=Flatten,7=PullZone,8=SRV,9=CAA,10=PTR,11=Script,12=NS
Flags for CAA records.
The value of the record (e.g., IP for A record).
Weight of the record (e.g., for SRV records).
Comment for the DNS record.
The DNS Zone ID to which the record will be added.
Whether the record is disabled.
Priority for MX records.
Script ID for Script record type.
Pull Zone ID for PullZone record type.
Whether accelerated routing is enabled.
Latency zone for latency-based routing.
Monitor type. 0=None,1=Ping,2=Http,3=Monitor.
Smart routing. 0=None,1=Latency,2=Geolocation.
Latitude for geolocation routing.
Longitude for geolocation routing.
List of environment variable objects for the record.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CREATE_LIVE_LIVE2Tool to retrieve live metrics data for database groups. Use when you need to fetch current performance metrics for specific group IDs.
Input parameters
Array of Database Group IDs. Each ID must be a string starting with 'group_' followed by a 26-character ULID (Universally Unique Lexicographically Sortable Identifier). Example: group_01HQWXYZ9ABCDEFGHJKMNPQRST
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CREATE_PULL_ZONECreates 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
Input parameters
Name of the pull zone. This will be used to generate the default CDN hostname (e.g., 'my-pull-zone' becomes 'my-pull-zone.b-cdn.net'). Must be unique across all BunnyCDN users.
Type of pull zone. 0 = Standard (Premium) pull zone with global edge locations, 1 = Volume pull zone optimized for high bandwidth workloads. Defaults to 0 (Standard).
The origin server URL from which BunnyCDN will fetch and cache content. Must be a valid HTTP/HTTPS URL pointing to your source server.
Enable TLS 1.0 protocol support. Not recommended for security reasons; only enable for legacy client compatibility.
Pricing tier for the pull zone. 0 = Standard tier with all regions, 1 = High Volume tier with reduced pricing but fewer edge locations.
AWS Access Key ID for S3 authentication. Required if aws_signing_enabled is true.
Pass the original Host header to the origin server. Enable if your origin requires the Host header for routing or virtual hosting.
Enable access logging for the pull zone. When enabled, request logs are recorded and available for analysis. Default is true.
ID of a BunnyCDN storage zone to use as the origin instead of an external URL. When set, the pull zone will serve files from the linked storage zone.
Enable automatic WebP image optimization. When enabled, images will be converted to WebP format for browsers that support it, reducing file sizes by 25-35%.
Enable content delivery from African edge locations. Enabled by default.
Enable content delivery from Antarctica edge locations. Rarely needed optional region.
Enable content delivery from European edge locations. Enabled by default.
Enable content delivery from Middle East edge locations. Optional additional region.
Enable content delivery from Oceania/Australia edge locations. Optional additional region.
Enable content delivery from South American edge locations. Enabled by default.
Enable content delivery from US/North America edge locations. Enabled by default.
AWS Secret Access Key for S3 authentication. Required if aws_signing_enabled is true.
Enable cache slicing for large file downloads. When enabled, large files are split into 1MB chunks allowing parallel downloads and faster delivery. Recommended for video/large file delivery.
Enable AWS Signature V4 authentication for S3-compatible origins. Required when pulling from private S3 buckets or S3-compatible storage.
Enable content delivery from Asia/Pacific edge locations. Enabled by default.
Port number of the syslog server for log forwarding. Common ports: 514 (UDP), 6514 (TCP/TLS). Required if log_forwarding_enabled is true.
Add Link header with canonical URL to responses. Helps search engines understand the canonical version of cached content.
Cache content separately for each hostname. Enable if different hostnames serve different content on the same pull zone.
Enable Origin Shield to reduce origin load. All edge requests pass through a shield POP first, improving cache hit ratio and reducing origin requests by up to 70%.
When enabled, query string parameters are ignored when caching. Useful when query strings don't affect content (e.g., tracking parameters). Default is true.
Authentication token for log forwarding to services that require it (e.g., Datadog API key, Splunk HEC token).
AWS region name for S3 authentication (e.g., 'us-east-1', 'eu-west-1'). Required if aws_signing_enabled is true.
Enable real-time log forwarding to an external syslog server. Useful for integrating with log aggregation tools like Splunk, Datadog, or ELK.
Save access logs to a BunnyCDN storage zone for long-term storage and analysis. Requires logging_storage_zone_id to be set.
ID of the storage zone where access logs will be saved. Required if logging_save_to_storage is true.
Two-letter zone code for the origin shield location. Should be closest to your origin server. Common codes: FR (Frankfurt), NY (New York), SG (Singapore), LA (Los Angeles).
Cache content separately for each country. Enable if content varies by visitor's geographic location (e.g., geo-targeted content).
Hostname or IP address of the syslog server for log forwarding. Required if log_forwarding_enabled is true.
Override the Cache-Control max-age header value in seconds. Use -1 to respect origin headers, 0 for no caching, or a positive value for specific TTL. Common values: 3600 (1 hour), 86400 (1 day).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CREATE_SHIELD_RATE_LIMITTool 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.
Input parameters
Name of the rate limit rule for identification.
ID of the Shield zone where the rate limit rule will be applied.
Description of the rate limit rule's purpose.
Configuration object defining the rate limit rule behavior.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_CREATE_SHIELD_ZONE_ACCESS_LISTTool 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.
Input parameters
The display name for the new access list.
The type of access list: 0=IP Address, 1=Country, 2=ASN, 3=JA3 Fingerprint.
The initial content for the access list with entries separated by newlines.
SHA-256 checksum of the content for integrity verification. If null, it will be automatically calculated.
Optional description of the access list's purpose or contents.
The ID of the Shield Zone to which the Custom Access List will be associated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_CONTAINER_REGISTRYTool to delete a container registry from Magic Containers. Use when you need to remove a container registry after confirming its ID.
Input parameters
Unique identifier of the container registry to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_DATABASETool to delete a BunnyCDN database by its ID. Use when you need to permanently remove an existing database after confirming the database ID.
Input parameters
The unique database identifier (starts with 'db_')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_DNS_RECORDTool to delete a specific DNS record by its ID. Use after confirming the DNS zone ID and record ID.
Input parameters
Unique identifier of the DNS zone containing the record.
Unique identifier of the DNS record to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_DNS_ZONETool 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.
Input parameters
Unique identifier of the DNS zone to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_EDGE_RULETool 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.
Input parameters
The ID of the Edge Rule that should be deleted.
The ID of the Pull Zone that contains the Edge Rule.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_GROUPTool to delete a specific database group by its ID. Use when you need to remove a group from the database.
Input parameters
The ULID identifier of the group to delete. Must start with 'group_' followed by a valid ULID format (26 characters, base32 encoded).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_PULL_ZONETool to delete a specific pull zone by its ID. Use when you need to remove a pull zone after confirming its ID.
Input parameters
Unique identifier of the pull zone to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_SHIELD_ZONE_ACCESS_LISTTool 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.
Input parameters
The ID of the Custom Access List to delete.
The ID of the Shield Zone to which the Custom Access List belongs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_DELETE_STORAGE_ZONETool 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.
Input parameters
Unique identifier of the storage zone to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GENERATE2FA_VERIFICATIONTool to generate 2FA verification details for account security setup. Use when setting up two-factor authentication for a BunnyCDN account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GENERATE_DATABASE_AUTH_TOKENTool to generate an authentication token for a BunnyCDN database. Use when you need to create access credentials for database operations.
Input parameters
Database ID in ULID format. Must start with 'db_' (e.g., 'db_01KHB7B3RQ1SP3KT6KRYHCAMRH').
Authorization level for the generated token. 'full-access' grants read and write permissions, 'read-only' grants only read permissions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_BILLING_SUMMARYTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_COINIFY_BTC_EXCHANGE_RATETool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_CONTAINER_CONFIG_SUGGESTIONSTool 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.
Input parameters
Image tag or version to use for configuration suggestions.
Container image name to analyze for configuration suggestions.
Registry identifier. Use 'dockerhub' for Docker Hub, 'github' for GitHub Container Registry, or provide a private registry ID.
Image namespace or owner. For Docker Hub official images, use 'library'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_CONTAINER_IMAGE_DIGESTTool 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.
Input parameters
Image tag to retrieve the digest for (e.g., 'latest', 'v1.0.0').
Container image name to query for the digest.
Registry identifier (e.g., 'dockerhub', 'github', or a private registry ID).
Image namespace (e.g., 'library' for official Docker Hub images, or an organization/user name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_DATABASETool to retrieve details of a specific database by its ID. Use when you need database configuration, size information, and region settings.
Input parameters
Database ID with 'db_' prefix (e.g., db_01KHB7B3RQ1SP3KT6KRYHCAMRH). Use BUNNYCDN_LIST_DATABASES to get valid database IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_DATABASE_STATISTICSTool 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.
Input parameters
End date/time in ISO 8601 format for the statistics range (e.g., 2026-02-13T23:59:59Z). Must be after 'from' parameter.
Start date/time in ISO 8601 format for the statistics range (e.g., 2026-02-01T00:00:00Z). Must be before 'to' parameter.
Database ID with 'db_' prefix (e.g., db_01KHB7B3RQ1SP3KT6KRYHCAMRH). Use BUNNYCDN_GET_DATABASE or BUNNYCDN_LIST_DATABASES to get valid database IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_DNS_ZONE_DETAILSTool to retrieve details of a specific DNS zone by its ID. Use when you need to verify DNS zone configuration after creation or update.
Input parameters
Unique identifier of the DNS zone to retrieve. Obtain this from the Get DNS Zone List action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_DNS_ZONE_LISTTool to list all DNS zones in your Bunny CDN account. Use when you need an overview of all configured DNS zones.
Input parameters
Page number for paginated results, starting at 1.
Number of DNS zones to return per page (1-1000).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_GROUPTool 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.
Input parameters
The ID of the database group to retrieve. Must be a ULID format starting with 'group_' followed by 26 alphanumeric characters (e.g., group_01KHB780B9MB0QJTFAQ0M6QCYK)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_LANGUAGESTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_LIMITSTool to retrieve current database limits for the authenticated BunnyCDN account. Use when you need to check database usage and capacity.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_OEMBEDTool to retrieve oEmbed metadata for BunnyCDN video embeds. Use when you need embed code or video metadata in oEmbed format.
Input parameters
The URL of the video to retrieve oEmbed data for. Should be in the format: https://iframe.mediadelivery.net/embed/{library_id}/{video_id}
Security token for accessing the video, if token authentication is enabled.
Token expiration timestamp (Unix timestamp in seconds).
Maximum width of the embedded video player in pixels.
Maximum height of the embedded video player in pixels.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_OPTIMAL_BASE_REGIONTool 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.
Input parameters
Optional CDN server token parameter for determining the optimal region. If not provided, the API will use default logic to determine the optimal region.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_OPTIMIZER_STATISTICSRetrieve 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.
Input parameters
The end date of the statistics in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). If not provided, the last 30 days will be returned.
If true, the statistics data will be returned in hourly grouping. If false or omitted, daily grouping is used.
The start date of the statistics in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). If not provided, the last 30 days will be returned.
The ID of the Pull Zone to retrieve optimizer statistics for. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_ORIGIN_SHIELD_QUEUE_STATISTICSTool 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.
Input parameters
The end date of the statistics in ISO 8601 format (e.g., '2024-01-31'). If not provided, the last 30 days will be returned.
If true, the statistics data will be returned in hourly grouping instead of daily. Defaults to false.
The start date of the statistics in ISO 8601 format (e.g., '2024-01-01'). If not provided, the last 30 days will be returned.
Unique identifier of the Pull Zone to retrieve Origin Shield statistics for. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_PREPARE_PAYMENT_AUTHORIZATIONTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_PULL_ZONETool to retrieve details of a specific Pull Zone. Use when you need full configuration and usage stats after confirming the Pull Zone ID.
Input parameters
Unique identifier of the Pull Zone to retrieve. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_PULL_ZONE_LISTRetrieve 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.
Input parameters
Page number for paginated results (0-indexed). Omit to use API default (page 0).
Search term to filter pull zones by name. Leave empty to return all pull zones.
Number of results per page (5-1000). Omit to use API default (1000).
Whether to include SSL certificate data in the hostname response. Omit for API default (false).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SAFE_HOP_STATISTICSTool 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.
Input parameters
The end date of the statistics in ISO 8601 format (e.g., '2024-01-31'). If not provided, statistics for the last 30 days will be returned.
If true, the statistics data will be returned in hourly grouping. If false or not provided, daily grouping is used.
The start date of the statistics in ISO 8601 format (e.g., '2024-01-01'). If not provided, statistics for the last 30 days will be returned.
The ID of the Pull Zone to retrieve SafeHop statistics for. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid Pull Zone IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_BOT_DETECTIONTool to retrieve bot detection configuration for a specific Shield Zone. Use when you need to view the current bot detection settings and sensitivity levels.
Input parameters
The ID of the Shield Zone to retrieve bot detection configuration for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_DDOS_ENUMSTool to retrieve available enums for Shield DDoS configuration. Use when you need to discover valid values for DDoS protection settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_EVENT_LOGSTool 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.
Input parameters
The Date (MM-dd-yyyy) of returned Event Logs. Format: MM-dd-yyyy (e.g., '02-13-2026').
The ID of the Shield Zone to retrieve event logs for.
The Continuation Token for the next page of Event Logs. Use empty string for the first page, then use the continuationToken from the response for subsequent pages.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_METRICS_BOT_DETECTIONTool to retrieve bot detection metrics for a specific Shield Zone. Use when you need to analyze bot traffic and challenges for a Shield Zone.
Input parameters
The ID of the Shield Zone to retrieve bot detection metrics for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_METRICS_OVERVIEWTool 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.
Input parameters
The ID of the Shield Zone to retrieve metrics for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_METRICS_OVERVIEW_DETAILEDTool 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.
Input parameters
End date for the metrics period in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). If not provided, defaults to the current time.
Start date for the metrics period in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). If not provided, defaults to a time period determined by the API.
Resolution for metrics aggregation.
The ID of the Shield Zone to retrieve metrics for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_METRICS_RATE_LIMIT_IDTool 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.
Input parameters
The ID of the Rate limit.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_METRICS_RATE_LIMITSTool to retrieve rate limit metrics for a Shield Zone. Use when you need to analyze rate limiting patterns and statistics for DDoS protection.
Input parameters
The ID of the Shield Zone to retrieve rate limit metrics for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_METRICS_UPLOAD_SCANNINGTool 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.
Input parameters
The ID of the Shield Zone to retrieve upload scanning metrics for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_METRICS_WAF_RULETool 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.
Input parameters
The ID of the WAF Rule.
The ID of the Shield Zone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_PROMO_STATETool to retrieve a breakdown of Shield promotional data. Use when you need information about current, eligible, and enrolled Shield promotions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_RATE_LIMIT_IDTool 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.
Input parameters
The ID of the Rate Limit to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_RATE_LIMITSTool 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.
Input parameters
Page number of results. Defaults to 1 if not specified.
The amount of results returned on one page. Defaults to 10 if not specified.
The ID of the Shield Zone associated with the Rate Limits
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_SHIELD_ZONESTool 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.
Input parameters
The page number of results.
The amount of results returned on one page.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_UPLOAD_SCANNINGTool to retrieve upload scanning configuration for a Shield Zone. Use when you need to check antivirus and CSAM scanning settings for uploaded files.
Input parameters
The ID of the Shield Zone to retrieve upload scanning configuration for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_CUSTOM_RULE_IDTool 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.
Input parameters
The ID of the Custom WAF Rule.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_CUSTOM_RULESTool 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.
Input parameters
The page number of results to retrieve.
The amount of results returned on one page.
The ID of the Shield Zone associated with the Custom WAF Rules.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_ENGINE_CONFIGTool to retrieve Shield WAF engine configuration settings. Use when you need to view the current WAF engine configuration parameters and their values.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_ENUMSTool to retrieve available enums for Shield WAF configuration. Use when you need to discover valid values for WAF protection settings.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_PROFILESTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_RULES_PLAN_SEGMENTATIONTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_RULES_REVIEW_TRIGGEREDTool 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.
Input parameters
The ID of the Shield Zone for the Triggered Rules.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_WAF_RULES_SHIELD_ZONE_IDTool 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.
Input parameters
The ID of the Shield Zone for the WAF Rules.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_ZONETool 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.
Input parameters
The ID of the Shield Zone to retrieve. Use this to get detailed configuration of a specific shield zone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_ZONE_ACCESS_LISTTool 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.
Input parameters
The ID of the Custom Access List to retrieve.
The ID of the Shield Zone to which the Custom Access List belongs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_ZONE_ACCESS_LIST_ENUMSTool 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.
Input parameters
The ID of the Shield Zone to retrieve access list enums for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_ZONE_ACCESS_LISTSTool 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.
Input parameters
The ID of the Shield Zone to which the Access Lists belong.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_ZONE_BY_PULLZONETool 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.
Input parameters
The ID of the Pull Zone to retrieve Shield Zone details for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_SHIELD_ZONES_PULLZONE_MAPPINGTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_STATISTICSTool 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.
Input parameters
The end date of the statistics in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). If not provided, the last 30 days will be returned.
If true, the statistics data will be returned in hourly grouping. If false or omitted, daily grouping is used.
The start date of the statistics in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). If not provided, the last 30 days will be returned.
If set, the statistics will be only returned for the given Pull Zone ID. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.
If set to true, the response will contain the non-2xx response statistics.
If set, the statistics will be only returned for the given region ID.
If true, loads bandwidth used statistics.
If true, loads origin traffic statistics.
If true, loads requests served statistics.
If true, loads user balance history data.
If true, loads origin response time statistics.
If true, loads origin shield bandwidth statistics.
If true, loads geographic traffic distribution data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_STORAGE_ZONE_DETAILSTool 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.
Input parameters
Unique identifier of the storage zone to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_STORAGE_ZONE_LISTTool to list all storage zones in your Bunny CDN account. Use when you need an overview of all configured storage zones.
Input parameters
Page number for paginated results, starting at 1.
Number of results per page (max 1000). Default is 100.
Whether to include deleted storage zones in the results. Default is False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_USER_AUDITTool 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.
Input parameters
Date in YYYY-MM-DD format for which to retrieve audit logs. Must be a valid date string.
Maximum number of audit log entries to return per page. Use with ContinuationToken for pagination.
Enum for order direction.
Filter by actor ID(s). Can be used to narrow down audit logs to specific actors who performed actions.
Filter by product(s). Can be used to narrow down audit logs to specific products.
Filter by resource ID(s). Can be used to narrow down audit logs to specific resources.
Filter by resource type(s). Can be used to narrow down audit logs to specific resource types.
Token for pagination to retrieve the next page of results. Obtain from previous response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_USER_DETAILSTool to retrieve complete details of the currently authorized user account. Use when you need account information, billing status, or user profile data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_USER_LIMITSTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_GET_WHATS_NEW_ITEMSTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_INVALIDATE_DATABASE_AUTH_TOKENSTool to invalidate all authentication tokens for a BunnyCDN database. Use when you need to revoke all active access credentials for a specific database.
Input parameters
Database ID in ULID format. Must start with 'db_' (e.g., 'db_01KHB7B3RQ1SP3KT6KRYHCAMRH').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_INVALIDATE_GROUP_AUTHTool to invalidate authentication tokens for a specific database group. Use when you need to revoke all active tokens for a group.
Input parameters
The database group ID. Must be a ULID prefixed with 'group_' (e.g., group_01KHB780B9MB0QJTFAQ0M6QCYK)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_API_KEYSTool 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.
Input parameters
Page number for paginated results, starting at 1.
Number of results per page (max 1000). Default is 1000.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_APPLICATIONSTool 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.
Input parameters
Maximum number of applications to return per request (1-1000). Default is 20.
Cursor for pagination to retrieve subsequent result sets. Omit for the first page.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_CONTAINER_IMAGE_TAGSTool 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.
Input parameters
Container image name to query for available tags.
Registry identifier (e.g., 'dockerhub', 'github', or a private registry ID).
Image namespace (e.g., 'library' for official Docker Hub images, or an organization/user name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_CONTAINER_REGISTRIESTool to list all container registries in your BunnyCDN Magic Containers account. Use when you need to view configured container registries with their connection details.
Input parameters
Number of items to return per page (1-1000). Default is 20 if not specified.
Cursor for pagination. Use the cursor from a previous response to fetch the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_COUNTRY_LISTTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_DATABASE_ACTIVETool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_DATABASE_CONFIGTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_DATABASES_V2Tool 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.
Input parameters
Page number for pagination, starting at 1
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_DATABASE_USAGETool 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.
Input parameters
End date/time in ISO 8601 format for the usage period (e.g., 2026-02-13T23:59:59Z). Must be after 'from' parameter.
Start date/time in ISO 8601 format for the usage period (e.g., 2026-02-01T00:00:00Z). Must be before 'to' parameter.
Database ID with 'db_' prefix (e.g., db_01KHB7B3RQ1SP3KT6KRYHCAMRH). Use BUNNYCDN_GET_DATABASE or BUNNYCDN_LIST_DATABASES to get valid database IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_DATABASE_VERSIONSTool 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.
Input parameters
The unique identifier of the database with 'db_' prefix. Use BUNNYCDN_LIST_DATABASES or BUNNYCDN_GET_DATABASE to get valid database IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_EDGE_SCRIPTSRetrieve 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.
Input parameters
Page number for paginated results, starting at 1. Omit to use API default (1).
Filter by edge script type. Provide a list of type IDs to filter results.
Search term to filter edge scripts by name. Leave empty to return all scripts.
Number of results per page (1-1000). Omit to use API default (1000).
Filter by linked integration ID. Omit to return scripts from all integrations.
Whether to include linked pull zones in the response. Omit for API default (false).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_GROUPTool to retrieve a list of all database groups in your BunnyCDN account. Use when you need to discover existing database groups and their configuration.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_GROUP_STATISTICSTool 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.
Input parameters
End date/time in ISO 8601 format for the statistics range (e.g., 2024-12-31T23:59:59Z). Must be after 'from' parameter.
Start date/time in ISO 8601 format for the statistics range (e.g., 2024-01-01T00:00:00Z). Must be before 'to' parameter.
The ID of the database group to retrieve statistics for. Must be a ULID format starting with 'group_' followed by 26 alphanumeric characters (e.g., group_01KHB780B9MB0QJTFAQ0M6QCYK)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_GROUP_USAGETool 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.
Input parameters
End date/time in ISO 8601 format for the usage aggregation period (e.g., 2026-02-13T23:59:59Z). Must be after 'from' parameter.
Start date/time in ISO 8601 format for the usage aggregation period (e.g., 2026-01-01T00:00:00Z). Must be before 'to' parameter.
The ID of the database group to retrieve usage for. Must be a ULID format starting with 'group_' followed by 26 alphanumeric characters (e.g., group_01KHB780B9MB0QJTFAQ0M6QCYK)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_NODESTool 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.
Input parameters
Number of items to return per page (1-1000). Default is 20 if not specified.
Cursor for pagination. Use the cursor from a previous response to fetch the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_NOTIFICATIONSTool to list all notifications for the currently logged in user. Use when you need to retrieve notifications.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_REGION_LISTTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_REGIONSTool 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.
Input parameters
Number of regions to return per page (1-1000). Default is 20 if not specified.
Pagination cursor for retrieving the next page of results. Omit for the first page.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_VIDEO_LIBRARIESRetrieve 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.
Input parameters
Page number for paginated results (0-indexed). Default is 0.
Search term to filter video libraries by name. Leave empty to return all video libraries.
Number of results per page (1-1000). Default is 1000.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_LIST_VOLUMESTool 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.
Input parameters
Application identifier for which to list volumes
Number of items to return per page (1-1000). Default is 20 if not specified.
Cursor for pagination. Use the cursor from a previous response to fetch the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_POST_SHIELD_WAF_RULES_REVIEW_TRIGGEREDTool 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.
Input parameters
Action to apply to the triggered rule. Choose 'allow' to whitelist, 'block' to deny, or 'challenge' to require verification.
The ID of the specific WAF rule to apply the action to. This field is required by the API.
The ID of the Shield Zone for the Triggered Rule.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_PURGE_PULL_ZONEPurges 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.
Input parameters
The numeric ID of the pull zone whose cache should be purged. Use the 'Get Pull Zone List' action to find available pull zone IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_PURGE_URLPurge 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.
Input parameters
The full URL of the cached content to purge. Must include the complete URL with protocol (https://) and the BunnyCDN pull zone hostname (e.g., your-zone.b-cdn.net). The URL must belong to a pull zone you own.
If true, the purge request returns immediately without waiting for completion (non-blocking). If false (default), waits for the purge to complete before returning.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_REMOVE_ALLOWED_REFERERRemoves 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.
Input parameters
The ID of the pull zone from which the allowed referer will be removed. Use the 'Get Pull Zone List' action to find available pull zone IDs.
The hostname that will be removed from the allowed referer list. This must match an existing allowed referer exactly (e.g., 'example.com', 'www.mysite.com').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_REMOVE_BLOCKED_IPTool 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.
Input parameters
The ID of the Pull Zone from which the IP will be unblocked. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.
The IP address that will be removed from the blocked list. Supports IPv4 and IPv6 formats.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_REMOVE_BLOCKED_REFERERTool 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.
Input parameters
The ID of the pull zone from which the blocked referer will be removed. Use the 'Get Pull Zone List' action to find available pull zone IDs.
The hostname that will be removed from the blocked referer list. After removal, requests with this referer will no longer be blocked.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_RESET_PULL_ZONE_SECURITY_KEYTool to reset the security token key for a specific pull zone. Use when you need to regenerate the security key for authentication purposes.
Input parameters
The ID of the requested Pull Zone whose security key should be reset.
Optional custom security key to set. If not provided, a random key will be generated. Must be between 8 and 36 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_RESET_WHATS_NEWTool 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_RESTORE_DATABASETool 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.
Input parameters
The unique database identifier (starts with 'db_'). Use BUNNYCDN_LIST_DATABASES to get valid database IDs.
The UUID of the generation/version to restore to (32-character hexadecimal UUID format without dashes, e.g., '00000000000000000000000000000001'). This is a destructive operation that will restore the database to this specific point in time.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_SEARCH_GLOBAL_SEARCHPerform 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.
Input parameters
Number of results to skip for pagination. Default is 0.
Maximum number of results to return. Default is 20.
The search query term to find resources by name. Leave empty to return all resources.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_SEARCH_PUBLIC_CONTAINER_IMAGESTool 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.
Input parameters
Page number for pagination. Defaults to 1 if not specified.
Results per page. Defaults to API default if not specified.
Search term for image discovery. Returns images whose names match this prefix.
Registry identifier - accepts 'dockerhub', 'github', or private registry IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_SET_EDGE_RULE_ENABLEDTool 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.
Input parameters
Set to true to enable the edge rule, false to disable it. Disabled rules remain configured but do not execute.
The ID of the Edge Rule that should be updated. This is a UUID (GUID) identifier returned when creating an edge rule.
The ID of the Pull Zone that contains the Edge Rule. Use BUNNYCDN_GET_PULL_ZONE_LIST to get valid IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_SET_FORCE_SSLTool to set Force SSL on a pull zone hostname. Use when you need to enable or disable HTTPS enforcement for a specific hostname.
Input parameters
The ID of the requested Pull Zone. Use the 'Get Pull Zone List' action to find available pull zone IDs.
Set to true to force SSL on the given pull zone hostname. When enabled, all HTTP requests will be redirected to HTTPS.
The hostname that will be updated. This should be one of the hostnames associated with the pull zone (e.g., 'test-pull-zone-minimal-001.b-cdn.net').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_SET_NOTIFICATIONS_OPENEDTool to mark all user notifications as opened. Use when you need to clear unread notification indicators. Returns success once notifications are marked as read.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_DATABASETool to update an existing Bunny Database. Use when you need to change database name or control read/write access.
Input parameters
Updated database name
Database ID with 'db_' prefix (e.g., db_01KHB7B3RQ1SP3KT6KRYHCAMRH). Use BUNNYCDN_LIST_DATABASES or BUNNYCDN_GET_DATABASE to get valid database IDs.
Whether to block read operations on the database
Whether to block write operations on the database
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_GROUPTool to update a database group by its ID. Use when you need to modify the name or configuration of a database group.
Input parameters
Updated name for the database group
The ID of the database group to update. Must be a ULID format starting with 'group_' followed by 26 alphanumeric characters (e.g., group_01KHB7B3JHCANBBAWPTXSEZH1H)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_PULL_ZONETool to update settings for a specific pull zone. Use when you need to modify existing pull zone settings after reviewing current configuration.
Input parameters
ID of the pull zone to update
New name for the pull zone.
Type of pull zone. 0 for standard pull zone.
New origin server URL from which BunnyCDN will pull content.
Enable TLS 1.0.
Pricing tier for the pull zone. 0=Standard, 1=High Volume.
AWS signing key.
Add a host header.
Enable logging.
ID of the storage zone to link, if applicable.
Disable cookies.
Enable WebP vary.
Enable the Africa region.
Enable the Antarctica region.
Enable the EU region.
Enable the Middle East region.
Enable the Oceania region.
Enable the South America region.
Enable the US region.
AWS signing secret.
List of country codes from which traffic is blocked.
Enable cache slicing.
Enable AWS signing.
Enable the Asia region.
Port to which logs are forwarded.
Add a canonical header.
Enable hostname vary.
Enable origin shield.
Ignore query strings when caching.
Token used for log forwarding authentication.
Cache error responses.
AWS signing region name.
Enable log forwarding.
Save logs to storage.
ID of the storage zone where logs are saved.
Zone code for origin shield.
Enable country code vary.
Hostname to which logs are forwarded.
List of country codes to which traffic is redirected for budget reasons.
Enable query string ordering.
Override the max-age directive in the Cache-Control header.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_SHIELD_BOT_DETECTIONTool 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.
Input parameters
IP address configuration for bot detection.
The ID of the Shield Zone to update bot detection configuration for.
Execution mode for bot detection.
Request integrity configuration for bot detection.
Browser fingerprint configuration for bot detection.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_SHIELD_RATE_LIMIT_IDTool 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.
Input parameters
The ID of the Rate Limit to update.
Name of the rate limit rule.
Human-readable description of the rate limit rule.
Configuration details for the rate limit rule.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_SHIELD_ZONETool to update configuration settings for a Shield Zone. Use when you need to modify DDoS protection settings, WAF rules, or security configurations.
Input parameters
Shield Zone configuration settings to update. Only include the fields you want to modify.
The ID of the Shield Zone to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_SHIELD_ZONE_ACCESS_LISTTool 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.
Input parameters
The ID of the Custom Access List to update.
The new display name for the access list. If null, the current name is preserved.
The new content for the access list with entries separated by newlines. If null, the current content is preserved.
SHA-256 checksum of the new content for integrity verification. If null, it will be automatically calculated.
The ID of the Shield Zone to which the Custom Access List belongs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_SHIELD_ZONE_ACCESS_LIST_CONFIGURATIONTool 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.
Input parameters
The ID of the Access List Configuration to update.
Enum for access list configuration actions.
Whether the access list should be enabled or disabled. If null, the current state is preserved.
The ID of the Shield Zone to which the Access List Configuration belongs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_SHIELD_ZONE_UPLOAD_SCANNINGTool to update upload scanning settings for a shield zone. Use when you need to configure antivirus and CSAM scanning for uploaded files.
Input parameters
Enable or disable upload scanning. If true, files uploaded to this shield zone will be scanned according to the configured scanning modes.
Unique identifier of the shield zone to update upload scanning settings for.
CSAM (Child Sexual Abuse Material) scanning mode for uploaded files.
Antivirus scanning mode for uploaded files.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_STORAGE_ZONETool 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.
Input parameters
Unique identifier of the storage zone to update.
Backup origin URL. When a file is not found in the storage zone, Bunny will attempt to proxy and fetch it from this URL instead. Set to empty string to remove.
If true, 404 errors will be returned as 200 OK status codes. Useful for single-page applications where routing is handled client-side.
List of region codes for data replication. Valid codes: DE (Frankfurt), UK (London), SE (Stockholm), CZ (Prague), ES (Madrid), NY (New York), LA (Los Angeles), WA (Seattle), MI (Miami), SG (Singapore), HK (Hong Kong), JP (Tokyo), SYD (Sydney), BR (Sao Paulo), JH (Johannesburg).
Path to a custom 404 error page file within the storage zone. This file will be served when a requested file is not found.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_UPDATE_USER_DETAILSTool to update the currently authorized user's account details. Use when modifying user profile information, billing details, or email preferences.
Input parameters
Sets the city name of the user's address.
Sets the user email. Must be a valid email format.
Sets the country of the user's address. Must be a two-letter country code (ISO 3166-1 alpha-2).
Sets the ZIP code of the user's address.
Sets the last name of the account owner.
Sets the login password for the user account. OldPassword should also be sent when changing password.
Sets the abuse email where abuse notifications are sent. Must be a valid email format.
Sets the first name of the account owner.
Sets the VAT number used for the billing details.
Sets the company name of the company responsible for the account.
The verification password when changing the password through the Password property. Required if Password is provided.
Sets the billing email where the invoices will be sent. Must be a valid email format.
Sets the street name and number of the user's address.
Determines if the account should receive promotional emails from bunny.net.
Determines if the account should receive notification emails from bunny.net.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BUNNYCDN_VALIDATE_ORIGIN_URL_PULL_ZONETool 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.
Input parameters
The origin URL to validate. Must be a valid HTTP/HTTPS URL that will be used as the content source for a pull zone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 33 agents privately built on Nagent that already use BunnyCDN.
Build on Nagent
Connect BunnyCDN to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find BunnyCDN, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, BunnyCDN is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once BunnyCDN is connected, you configure its 129 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop BunnyCDN steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a BunnyCDN event fires, the agent kicks off automatically.
Every BunnyCDN action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While BunnyCDN ships with 129 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching BunnyCDN together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build BunnyCDN-based workflows tailored to your business.