CDN

Update CDN Zone

patch/cdn/zones/{zone_uuid}

Update a CDN zone.

SSL options:

ssl_type='automatic' (default): Automatically provisions Let's Encrypt certificate
ssl_type='custom' + certificate_uuid: Uses an uploaded certificate

Returns the cname_target you must configure in your DNS.

Authorization

Authorization*string

Bearer YOUR_API_TOKEN with an API token. The X-API-Key: YOUR_API_TOKEN header works too.

Path parameters

zone_uuid*string

Request body

Update a CDN zone

application/jsonRequired

name?string | null

Range1 ≤ length ≤ 100

custom_domain?string | null

Range1 ≤ length ≤ 253

ssl_type?string | null

SSL type: automatic (Let's Encrypt) or custom

Rangepattern ^(automatic|custom)$

certificate_uuid?string | null

UUID of custom certificate

Range36 ≤ length ≤ 36

token_auth_enabled?boolean | null

Enable signed URL validation. Activating without a previously-set secret auto-generates one; the secret is returned in the response only on first generation. Use POST /cdn/zones/{uuid}/token-auth/rotate-secret to rotate.

token_auth_ip_binding?boolean | null

Bind signed URLs to the client IP. Tightens security against URL sharing but breaks for clients behind CGNAT or with rotating IPs.

cors_enabled?boolean | null

Enable CORS (Cross-Origin Resource Sharing) headers for this zone. Required when your content is fetched from JavaScript on another domain (HLS players, fetch APIs, etc.).

cors_allow_origins?string | null

Origins allowed to fetch this zone's content. Use "*" to allow any origin, or a comma-separated list of exact origins (scheme + host + optional port). Ignored when cors_enabled is false.

Rangelength ≤ 4096

Responses

Successful Response

application/json

detail*string

token_auth_secret?string | null