CDN

Public, permanent assets on a global edge. Images are re-encoded on upload and their EXIF, GPS, and camera metadata is stripped, see Permanent CDN Hosting for the product-level details.

List CDN assets

GET /cdn/assets. Requires cdn.read.

Query param	Type	Description
`limit`	integer	How many to return. Default 50, maximum 100.
`cursor`	string	The `next_cursor` from a previous page. Omit for the first page.

Retrieve a CDN asset

GET /cdn/assets/{id}. One asset by id. Requires cdn.read.

Start a CDN upload

POST /cdn/assets. Same three-step flow as files, see Uploading. CDN assets are public and permanent, they never expire and are not encrypted, because a browser has to be able to render them. Requires cdn.write.

Body param	Type	Required	Description
`name`	string	Yes	Filename. Becomes part of the public URL.
`size`	integer	Yes	Size in bytes, within your plan’s per-asset cap.
`content_type`	string	Yes	MIME type, e.g. `text/css`.

Finish a CDN upload

POST /cdn/assets/{id}/complete. Commits a new upload or a swap. The size is read back from storage, so your quota is charged for the bytes that actually landed. Requires cdn.write.

Swap an asset in place

POST /cdn/assets/{id}/swap. Replaces the bytes behind an existing asset while keeping its id and public URL, so anything already linking to it picks up the new version. PUT the bytes, then call complete. Requires cdn.write.

Body param	Type	Required	Description
`size`	integer	Yes	Size of the replacement in bytes.
`content_type`	string	Yes	MIME type of the replacement.

Delete a CDN asset

DELETE /cdn/assets/{id}. Removes the asset and its bytes. The public URL stops working immediately. Requires cdn.delete.

Example asset object

{
  "object": "cdn_asset",
  "id": "17agm92ngc43",
  "name": "styles.css",
  "size": 17,
  "content_type": "text/css",
  "created_at": "2026-07-19T21:04:12.000Z",
  "url": "https://r2.hypastack.com/cdn/17agm92ngc43/styles.css"
}

Guide

Endpoints

List CDN assets

Retrieve a CDN asset

Start a CDN upload

Finish a CDN upload

Swap an asset in place

Delete a CDN asset

​List CDN assets

​Retrieve a CDN asset

​Start a CDN upload

​Finish a CDN upload

​Swap an asset in place

​Delete a CDN asset

List CDN assets

Retrieve a CDN asset

Start a CDN upload

Finish a CDN upload

Swap an asset in place

Delete a CDN asset