CDN

Generate a signed URL

post/cdn/zones/{zone_uuid}/token-auth/sign-url

Generate a valid signed URL for a Token Auth zone without implementing the signing yourself. Useful for testing and for backends that prefer to delegate signing.

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

Generate a signed URL for a Token Auth-enabled zone.

application/jsonRequired

path*string

Range1 ≤ length ≤ 2048

expires_in?integer

Validity in seconds (60s..7d)

Range60 ≤ value ≤ 604800Default3600

client_ip?string | null

Required when the zone has token_auth_ip_binding enabled. The signature includes this IP.

Responses

Successful Response

application/json

detail*string

signed_url*string

token*string

expires*integer

Example request

POST/cdn/zones/{zone_uuid}/token-auth/sign-url

curl -X POST "https://api.cubepath.com/cdn/zones/3fa85f64-5717-4562-b3fc-2c963f66afa6/token-auth/sign-url" \
  -H "Authorization: Bearer $CUBEPATH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "path": "/videos/clip.mp4",
  "expires_in": 3600,
  "client_ip": "203.0.113.10"
}'

Example response

{
  "detail": "string",
  "signed_url": "string",
  "token": "string",
  "expires": 1
}