v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Origins

Create origin group

Create an origin group with one or more origin sources.

post/cdn/origin_groups

Request body

OR

Example request

{
  "name": "YourOriginGroup",
  "use_next": true,
  "proxy_next_upstream": [
    "error",
    "timeout",
    "invalid_header",
    "http_500",
    "http_502",
    "http_503",
    "http_504"
  ],
  "auth_type": "none",
  "sources": [
    {
      "source": "yourwebsite.com",
      "enabled": true,
      "tag": "default"
    }
  ]
}

Response

Successful.

OR

Example response

{
  "id": 1,
  "name": "YourOriginGroup",
  "use_next": true,
  "proxy_next_upstream": [
    "error",
    "timeout",
    "invalid_header",
    "http_500",
    "http_502",
    "http_503",
    "http_504"
  ],
  "auth_type": "none",
  "sources": [
    {
      "source": "yourwebsite.com",
      "backup": false,
      "enabled": true,
      "tag": "default",
      "host_header_override": null
    },
    {
      "source": "1.2.3.4:5500",
      "backup": true,
      "enabled": true,
      "tag": "default",
      "host_header_override": null
    },
    {
      "origin_type": "s3",
      "config": {
        "s3_type": "amazon",
        "s3_bucket_name": "my-bucket",
        "s3_region": "eu-west-1",
        "s3_access_key_id": "SECRET_VALUE",
        "s3_secret_access_key": "SECRET_VALUE",
        "s3_auth_type": "awsSignatureV4"
      },
      "backup": true,
      "enabled": true,
      "tag": "default",
      "host_header_override": null
    }
  ],
  "has_related_resources": true
}