📦 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"
}
}

curl --location --request DELETE 'https://api.tenbyte.io/admin/distributions/af392dc9-990b-484a-a9f9-33f47d551627' \ --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJjb25zb2xlLnZpZGluZnJhLmNvbSIsImV4cCI6MTc1NjE2MTgxMiwiaWF0IjoxNzU2MTE4NjEyLCJqdGkiOiI2MjI4MDQxZi0yZTFhLTQzMzQtYjdlNy0yOGE4MjJkZmQ3NDEiLCJlbWFpbCI6Im9zbWFubWFzdW0uY3NAZ21haWwuY29tIiwidXNlcm5hbWUiOiJNYXN1bSBPc21hbiIsInJvbGUiOiJvd25lciIsInVzZXJfaWQiOiJkYzMwNDVkOS03MGJiLTRkNGYtYTY1MC0yMmMxMzRkYzhmMjEiLCJzZXNzaW9uX2lkIjoiNjI4NmFlM2QtODM0Mi00NDBlLWJmM2UtNWQzOGJkZjUwNTk2Iiwib3JnYW5pemF0aW9uX2lkIjoiYzNhNzU5NjAtM2ZiYS00NGUwLTgyZjctZTU0ZWUyZDVhN2Y3In0.svWoA7S0Y1STKn2lFPnf13gpaHWLwmJQdAqmEuR8RaY5iUZM6IMaMNW3_ZylT5oylRb6cCMb_2KiSmqJHeFh5uWGSiDAyc-GD3BNLoBbDqqf6DoCF9f5xH2LRrj0SMLs4eoGsQOtRMBkz8XUaMnK1ezjGqJc8T0oNtYYAKktHE_q-jS-8N5bGOdeqekOj7M9wElPSeuTv_AYh6HWoWVaPRLfLDQna7XKuEO_cyWA5d9ngCXBkje0-ycruZ-b9NBcrS2fLUDaKeAYJ3MP7-__Yz8Ej1NmUQOFRdz1W1uZ_eCkatcoGYk5zxC3CtoZcBaYa9ZKub2WvIoB9rciW2rI9pmCNYe0WC4LRGSHs47mDUD4I9FbyWCrtuwKFqeKnN8JGHhpx2JDdAI4GcqkwVMJJIRswio9Xq8vqYN7MPnjifs8R5EDFy7yRAuuu4s2hIjKFTntfJuBk08tgRg-q4sxAGB9QAaYYgqmmHYDDioheHpZtjZORjkCNHBfAp0D2mEnuboYHJS06d2pKKg-_3R1qH_NjqPYW8_v5cEpRlZ2yGRx1g7mLFFRKB7CQIEyCIGsM88PkCS_84DqTu5_XcXif2MgfhNBux74ZBU6jv0YvDSTr3veUm_d3XdBMZY34OfGugJBrsIIjSZRmiqHDmk7Ci9dftK3aev6yOAs2Jfpvk4' \ --header 'Content-Type: application/json' \ --data '{}'

{ "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