CDN

Create Origin

post/cdn/zones/{zone_uuid}/origins

Create a new origin for a CDN zone. You can provide a full origin_url (e.g., https://s3.example.com/bucket/) which will be automatically parsed. To serve one of your Object Storage buckets, pass object_storage_bucket_uuid instead of the connection fields: the origin is configured from the bucket and starts serving as soon as its access is ready.

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

Create a new CDN origin

application/jsonRequired

name*string

Range1 ≤ length ≤ 100

origin_url?string | null

Full origin URL (e.g., https://s3.example.com/bucket-name/). If provided, extracts address, port, protocol, host_header, and base_path automatically.

Rangelength ≤ 500

address?string | null

IP address or hostname

Range1 ≤ length ≤ 255

port?integer | null

Range1 ≤ value ≤ 65535

protocol?CDNOriginProtocol | null

Value in"http""https"

weight?integer

Range1 ≤ value ≤ 1000Default100

priority?integer

Range1 ≤ value ≤ 100Default1

is_backup?boolean

Defaultfalse

health_check_enabled?boolean

Defaulttrue

health_check_path?string

Rangelength ≤ 255Default"/health"

verify_ssl?boolean

Defaulttrue

host_header?string | null

Custom Host header to send to origin

Rangelength ≤ 255

base_path?string | null

Base path prefix for origin requests (e.g., /bucket-name)

Rangelength ≤ 255

enabled?boolean

Defaulttrue

s3_auth_enabled?boolean

Sign requests with AWS SigV4 for private S3-compatible buckets

Defaultfalse

s3_access_key?string | null

S3 access key ID

Range8 ≤ length ≤ 128

s3_secret_key?string | null

S3 secret access key (write-only)

Range8 ≤ length ≤ 128

s3_region?string | null

S3 region (e.g. us-east-1, eu-central-1)

Rangelength ≤ 64

s3_service?string

AWS service name (almost always 's3')

Rangelength ≤ 32Default"s3"

object_storage_bucket_uuid?string | null

Serve one of your Object Storage buckets. Leave out every connection field (origin_url, address, port, protocol, host_header, base_path, verify_ssl, health checks, enabled and the s3_* fields): they are set from the bucket, and the origin starts serving once its access is ready.

Rangelength ≤ 36

Responses

Successful Response

application/json

uuid*string

name*string

address*string

s3_auth_enabled*boolean

object_storage_bucket_uuid?string | null

detail*string