For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.cdn.purge_cache(
    cdn_id="19f06b6a-3ace-4315-b086-499a0e521b76",
    body={
        "files": [...],
    },
)

Description

To purge cached content from a CDN endpoint, send a DELETE request to /v2/cdn/endpoints/{cdn_id}/cache. The body of the request should include a files attribute containing a list of cached file paths to be purged. A path may be for a single file or may contain a wildcard (*) to recursively purge all files under a directory. When only a wildcard is provided, all cached files will be purged. There is a rate limit of 50 files per 20 seconds that can be purged. CDN endpoints have a rate limit of 5 requests per 10 seconds. Purging files using a wildcard path counts as a single request against the API’s rate limit. Two identical purge requests cannot be sent at the same time.

Parameters

cdn_id string required

A unique identifier for a CDN endpoint.

Min: 1

files array of strings required

Example: ['path/to/image.png', 'path/to/css/*']

An array of strings containing the path to the content to be purged from the CDN cache.

Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

purge_req = {"files": ["path/to/image.png", "path/to/css/*"]}

purge_resp = client.cdn.purge_cache("19f06b6a", purge_req)

More Information

See /v2/cdn/endpoints/{cdn_id}/cache in the API reference for additional detail on responses, headers, parameters, and more.