Smooth CDN logo

CDN API

Build your own asset delivery workflow

Use the Smooth CDN API to create projects, upload files, publish asset versions, and return optimized CDN URLs from your own backend, scripts, or release jobs.

Example API request
curl https://api.smoothcdn.com/projects \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Control the same pipeline from code

The API gives your backend, plugin, integration, or release job access to the same asset pipeline used by Smooth CDN CLI.

CLI / CI

Upload assets

Push images, video, CSS, JS, audio, PDFs, fonts, and static files.

Automatic

Optimize files

Create image variants, minify CSS / JS, optimize audio, video, and PDFs, compress, and cache.

CDN

Serve CDN URLs

Use stable optimized URLs in your app.

What you can automate

Use the API when asset delivery should happen inside your product, deployment flow, or internal tooling.

Project setup

Create and organize asset containers from your own backend, admin panel, or onboarding flow.

Asset uploads

Push files from scripts, release jobs, CMS workflows, or internal tools without dashboard steps.

Versioned packages

Publish grouped asset versions and mark the active version as latest when a release is ready.

Protected delivery

Apply basic token protection to selected files while keeping normal frontend assets public.

API keys

Authenticate server-side jobs, automation scripts, and CI/CD workflows with bearer tokens.

Custom automation

Build your own deployment flow, plugin, connector, or asset sync process on top of Smooth CDN.

Common API requests

Start with project setup, upload assets from your workflow, then read back CDN-ready files for your app, CMS, or integration.

Create project
curl https://api.smoothcdn.com/projects \
  -X POST \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Assets",
    "slug": "marketing-assets"
  }'
Upload assets
curl https://api.smoothcdn.com/upload/bulk \
  -X POST \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "projectId=<project-id>" \
  -F "assets=@./hero.png" \
  -F "assets=@./app.js" \
  -F "assets=@./styles.css"
List project assets
curl https://api.smoothcdn.com/projects/<project-id>/assets \
  -H "Authorization: Bearer <YOUR_API_KEY>"

API-first when CLI is not enough

Use the CLI for standard deployments. Use the API when asset delivery needs to be part of your own product, customer workflow, CMS integration, or backend automation.

  • • Build a custom CMS or marketplace integration
  • • Upload customer-generated assets from your backend
  • • Generate CDN URLs inside your own admin panel
  • • Connect asset delivery with internal release tools
  • • Protect selected files with token-based access

Automate CDN asset delivery from your own code

Generate an API key, connect your backend or release job, and publish optimized assets without manual upload steps.