📦 Distributions API Documentation

Endpoint

GET /v1/distributions

Query Parameters

📑 Pagination

Parameter Type Description

page number Page number (default: 1)

`limit` number Number of items per page (default: 15, min: 1, max: 50)

🔍 Filtering

You can filter by the following fields:

id

name

cname

domain

status

domain_type

cache_strategy

organization_id

certificate_id

enable_ssl

is_redirect_http_to_https

is_http2

is_http3

is_cname_valid

is_acme_challenge_valid

le_issue

created_at

updated_at

Operators

Operator Description

eq Equals
ne Not equals
like Contains (case insensitive)
not-like Does not contain
starts-with Starts with
ends-with Ends with
gt Greater than
gte Greater than or equal
lt Less than
lte Less than or equal
in In list (comma-separated)
not-in Not in list
null Is null
not-null Is not null
between Between two values (comma-separated)
not-between Not between two values (comma-separated)

Example Filters

filter[name][starts-with]=cdn-
filter[status][in]=active,disabled
filter[enable_ssl][eq]=true
filter[created_at][between]=2025-01-01,2025-08-01

↕ Sorting

Parameter Description

sort Sort fields. Prefix with - for descending. Allowed:
created_at, updated_at, name, status, domain_type,
cache_strategy, domain, cname

Example Sorts

sort=-created_at
sort=name
sort=-created_at,name

📌 Example Requests

1. Prefix search + newest first

GET /v1/distributions?filter[name][starts-with]=cdn-&sort=-created_at

2. Status + type + alphabetical

GET /v1/distributions?filter[status][in]=active,disabled&filter[domain_type][eq]=system&sort=name

3. Created date range

GET /v1/distributions?filter[created_at][between]=2025-01-01,2025-08-01&sort=-created_at

4. SSL-only

GET /v1/distributions?filter[enable_ssl][eq]=true

✅ Success Response

Status: 200 OK
{
"success": true,
"count": 2,
"data": [
{
"id": "uuid",
"name": "cdn-example",
"status": "active",
"domain_type": "system",
"enable_ssl": true,
"created_at": "2025-02-01T12:00:00Z",
"updated_at": "2025-02-10T12:00:00Z"
}
]
}

❌ Error Response

Status: 400 Bad Request
{
"success": false,
"message": "Invalid filter query",
"errors": {
"filter": "Unsupported field or operator"
}
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request DELETE 'https://api-staging.tenbyte.io/v1/admin/distributions/af392dc9-990b-484a-a9f9-33f47d551627' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{}'

{ "data": [ { "created_at": "2025-08-24T16:31:22.696065Z", "host_header": "cdn233.tenbyte.com.my", "description": "test", "updated_at": "2025-08-24T16:31:22.696065Z", "acme_challenge_domain": "acme-challenge.getassl.com", "name": "Tenbyte CDN 2", "cname": "smartroute.tenbytecdn.com", "acme_challenge_cname": "_acme-challenge.cdn1222", "domain_type": "custom", "domain": "cdn1222.tenbyte.com.my", "status": "provisioning", "cache_strategy": "web", "id": "af392dc9-990b-484a-a9f9-33f47d551627", "organization_id": "0f39f14e-2bf8-40f3-a6ea-67bc7bb36a1f", "is_acme_challenge_valid": false, "enable_ssl": true, "le_issue": false, "is_redirect_http_to_https": true, "is_http2": true, "is_cname_valid": false, "is_http3": false } ], "meta": { "links": { "self": "/v1/admin/distributions?limit=20&page=1", "first": "/v1/admin/distributions?limit=20&page=1", "last": "/v1/admin/distributions?limit=20&page=1" }, "pagination": { "page": 1, "page_size": 20, "total": 1, "total_pages": 1 } }, "message": "Request processed successfully.", "success": true }

Delete Distribution List

📦 Distributions API Documentation

Endpoint

Query Parameters

`limit` number Number of items per page (default: 15, min: 1, max: 50)

🔍 Filtering

Operators

Example Filters

↕ Sorting

Example Sorts

📌 Example Requests

1. Prefix search + newest first

2. Status + type + alphabetical

3. Created date range

4. SSL-only

✅ Success Response

❌ Error Response

Request

Responses

Delete Distribution List

📦 Distributions API Documentation#

Endpoint#

Query Parameters#

📑 Pagination#

limit number Number of items per page (default: 15, min: 1, max: 50)#

🔍 Filtering#

Operators#

Example Filters#

↕ Sorting#

Example Sorts#

📌 Example Requests#

1. Prefix search + newest first#

2. Status + type + alphabetical#

3. Created date range#

4. SSL-only#

✅ Success Response#

❌ Error Response#

Request

Responses

📦 Distributions API Documentation

Endpoint

Query Parameters

📑 Pagination

`limit` number Number of items per page (default: 15, min: 1, max: 50)

🔍 Filtering

Operators

Example Filters

↕ Sorting

Example Sorts

📌 Example Requests

1. Prefix search + newest first

2. Status + type + alphabetical

3. Created date range

4. SSL-only

✅ Success Response

❌ Error Response