Get CDN distribution
Returns a CDN distribution’s origin, cache policy, domains, and status. Requires scope: cdn.read.
Authentication
AuthorizationBearer
IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.
Path parameters
distribution_id
CDN distribution ID.
Query parameters
workspace_id
The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.
Response
Distribution returned successfully.
id
Unique ID of the distribution.
name
Display name of the distribution.
origin_type
bucket: an Object Storage bucket.custom: a custom origin.
Allowed values:
origin_id
Bucket name or custom origin ID.
cache_policy
Caching behaviour in effect.
static-assets: long-term caching for immutable assets; 1 year at the CDN, browsers revalidate.media: medium-term caching for video and audio; 30 days at the CDN.short: short-term caching for frequently changing content; 1 hour at the CDN.no-cache: no caching, for dynamic responses.
enabled
Whether the distribution serves traffic.
status
active: serving.deploying: configuration is being rolled out to the edge.disabled: turned off.failed: deployment failed.deleted: removed.
Allowed values:
default_domain
Hostname IBEE assigned to the distribution, for example dl-abc123.cdn.ibee.ai.
default_url
https:// URL of default_domain.
custom_domains
Custom hostnames attached to the distribution.
created_at
When the distribution was created (ISO 8601).
updated_at
When the distribution was last changed (ISO 8601).
Errors
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
413
Content Too Large Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error
503
Service Unavailable Error
504
Gateway Timeout Error
