Smooth CDNSmooth CDN
Smooth CDN logo

Asset Management API

Manage your frontend assets through a simple CDN API

Upload, organize, version and optimize frontend assets programmatically using the Smooth CDN API. Perfect for applications, deployment pipelines and custom integrations.

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

More than file uploads

Smooth CDN API manages the asset workflow around your files: projects, folders, versions, optimization and URL retrieval. It is not just object storage with a public URL.

Upload frontend assets

Send images, JavaScript, CSS, fonts, PDFs, video, and generated files from your own code.

Organize projects

Create asset containers for apps, customers, environments, or product areas.

Manage folders

Keep uploaded files grouped by path, build output, feature, or integration.

Create versions

Publish predictable asset releases and keep old versions addressable.

Retrieve optimized URLs

Read back CDN-ready URLs for apps, CMS entries, customer dashboards, or generated content.

Automate workflows

Connect asset publishing with backends, release jobs, internal tools, and integrations.

API examples developers need first

Start with authentication, upload assets, retrieve optimized URLs, and create versions. The full reference is in the API documentation.

Authentication

Use bearer tokens from server-side code, scripts, or release jobs.

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

Upload example

Send one or many frontend assets as multipart files.

Upload example
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"

Asset retrieval

Read uploaded assets and store optimized URLs in your application.

Asset retrieval
curl https://api.smoothcdn.com/projects/<project-id>/assets \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Version management

Create named asset versions for predictable releases.

Version management
curl https://api.smoothcdn.com/projects/<project-id>/versions \
  -X POST \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"version":"1.2.1"}'

Typical API workflows

The API fits wherever assets are created by software, not uploaded by a person.

Generated images

  1. 1Application uploads generated images
  2. 2Backend stores files in Smooth CDN
  3. 3Optimization happens automatically
  4. 4Application receives CDN URLs

CMS media

  1. 1CMS generates media
  2. 2API uploads assets
  3. 3Smooth CDN prepares optimized files
  4. 4Website immediately serves optimized files

Release publishing

  1. 1CI/CD publishes release
  2. 2API uploads assets
  3. 3Version becomes available globally
  4. 4Application uses stable version URLs

Works with your stack

Call the API from server-side code, jobs, workers, CMS integrations, or internal tools.

Node.js backend

Laravel

Next.js API routes

Express

NestJS

Go

Python

PHP

Choose the right interface

The API is one way into the same Smooth CDN asset workflow. Use it when asset management belongs inside your own application or backend.

CLI

Best for deployment pipelines.

API

Best for applications and backend integrations.

Desktop App

Best for local folder synchronization.

WordPress plugin

Best for WordPress websites.

Start integrating in minutes

Create a free project and begin uploading assets through the API.

Read API docs
Create free project