Skip to main content
The Pxxl CDN API gives your backend direct access to object storage, asset management, and edge analytics. Use it to upload build artifacts, serve static files from edge cache nodes, track monthly bandwidth consumption, and pull proxy traffic logs for security analysis — all without leaving your deployment workflow. This page covers the raw HTTP endpoints. If you would rather use a typed client, jump to the Node SDK or Go SDK. For ready-to-deploy starter projects that already wire up uploads, see Boilerplates.

​
Endpoints

HTTP MethodAPI PathObjective
GET/api/v3/cdn/summaryQuery total bandwidth and remaining wallet credits.
GET/api/v3/cdn/assetsPaginate through your uploaded asset catalog.
POST/api/v3/cdn/assetsUpload a new asset to public or private spaces.
GET/api/v3/cdn/proxy-logsRetrieve traffic anomaly logs and edge events.

​
Upload an Asset

Send a multipart/form-data POST request to upload a file to your storage space. Set visibility to public for files served from edge cache nodes, or private for files accessed via pre-signed URLs. 
curl -X POST https://gateway.pxxl.dev/api/v3/cdn/assets \
  -H "Authorization: Bearer $PXXL_API_KEY" \
  -F "file=@./static/logo.png" \
  -F "visibility=public"

​
Check Usage Summary

Query your current storage and bandwidth consumption, along with remaining wallet credits: 
curl -H "Authorization: Bearer $PXXL_API_KEY" \
  https://gateway.pxxl.dev/api/v3/cdn/summary
The response returns the following fields:
​
activeSpaceCount
integer
Total number of CDN spaces you have created in your workspace.
​
bandwidthBytesOut
integer
Egress bytes served from cache nodes to end users during the current billing period.
​
totalObjectsStored
integer
Total count of files currently stored across all your CDN spaces.
​
remainingCredits
number
Wallet currency available for CDN plan upgrades or additional storage capacity.

​
Get Proxy Logs

Retrieve edge traffic logs and security anomaly events recorded by the Pxxl CDN proxy: 
curl -H "Authorization: Bearer $PXXL_API_KEY" \
  https://gateway.pxxl.dev/api/v3/cdn/proxy-logs
Proxy logs include allowed and blocked request counts, risk index ratings, GeoIP concentration breakdowns, and the top IP sources contributing the highest traffic volumes to your project domains.
If you accidentally expose a CDN upload API key in a client bundle, a public repository, or a build log, rotate it immediately from Dashboard > API Keys. Delete the compromised key, create a replacement with the same CDN upload and read scopes, and update the secret in your backend environment before redeploying.