Public API

API helper

These endpoints are the API equivalents of the Container App and Object Storage flows in the panel. All requests run within the authorized CDN account scope.

Back to Platform Help

Container Apps

GET    /api/accounts/{uuid}/platform/container/apps
POST   /api/accounts/{uuid}/platform/container/apps
PATCH  /api/accounts/{uuid}/platform/container/apps/{app_uuid}
GET    /api/accounts/{uuid}/platform/container/registry-credentials
POST   /api/accounts/{uuid}/platform/container/registry-credentials
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/deploy
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/restart
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/scale
GET    /api/accounts/{uuid}/platform/container/apps/{app_uuid}/status
GET    /api/accounts/{uuid}/platform/container/apps/{app_uuid}/logs
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/imports/database
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/imports/files
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/scheduled-jobs
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/scheduled-jobs/{job_uuid}/run
DELETE /api/accounts/{uuid}/platform/container/apps/{app_uuid}

Object Storage

GET    /api/accounts/{uuid}/platform/container/object-storage/buckets
POST   /api/accounts/{uuid}/platform/container/object-storage/buckets
POST   /api/accounts/{uuid}/platform/container/object-storage/access-keys
POST   /api/accounts/{uuid}/platform/container/object-storage/access-keys/{key_uuid}/rotate
DELETE /api/accounts/{uuid}/platform/container/object-storage/access-keys/{key_uuid}
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/object-storage/bindings

Authentication

Every endpoint requires a Bearer token scoped to your user. The quickest way to get one is cdnctl login; the token also works for direct curl/HTTP calls from scripts and CI.

# 1) authenticate once (stores the token in ~/.cdnctl/config.json)
cdnctl login --email you@example.com

# 2) call any endpoint directly with the same Bearer token
curl -H "Authorization: Bearer $TOKEN" \
  https://cdn.com.tr/api/accounts/{uuid}/platform/container/apps

Worked example: read an app's status

Responses are JSON. Non-2xx responses carry a status and a message field that explains what went wrong.

curl -H "Authorization: Bearer $TOKEN" \
  https://cdn.com.tr/api/accounts/{uuid}/platform/container/apps/{app_uuid}/status

# response (abridged)
{
  "status": "success",
  "app": { "uuid": "…", "name": "web", "status": "running", "replicas": 1 }
}

Good to know

These are the same endpoints the panel and cdnctl use — anything you can click, you can script.
Prefer "cdnctl container apps wait --status running" over tight polling loops when automating deploys.
Operations are asynchronous: mutating calls return an operation you can follow from the panel or via the status endpoint.