Create CDN distribution

POST

/cdn/distributions

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.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

Request

This endpoint expects an object.

namestringRequired1-128 characters

origin_idstringRequired>=1 character

origin_typeenumOptionalDefaults to bucket

cache_policyenumOptionalDefaults to static-assets

Response

Distribution created successfully.

idstring

namestring

origin_typeenum

origin_idstring

cache_policystring

enabledboolean

statusenum

default_domainstring

default_urlstringformat: "uri"

custom_domainslist of strings

created_atdatetime

updated_atdatetime or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

409

Conflict Error

$	curl -X POST "https://api.ibee.ai/v1/cdn/distributions?workspace_id=710995" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "string",
>	"origin_id": "string"
>	}'

1	{
2	"id": "string",
3	"name": "string",
4	"origin_type": "bucket",
5	"origin_id": "string",
6	"cache_policy": "string",
7	"enabled": true,
8	"status": "active",
9	"default_domain": "string",
10	"default_url": "string",
11	"custom_domains": [
12	"string"
13	],
14	"created_at": "2024-01-15T09:30:00Z",
15	"updated_at": "2024-01-15T09:30:00Z"
16	}