Skip to main content

Delivery key aliases

Create delivery keys with a short public alias (marketing, site, products) instead of embedding the full cvly_pub_… token in every URL.
POST /api/delivery-keys
{ "name": "Marketing site", "alias": "marketing" }
Check availability with GET /api/delivery-keys/alias?alias=marketing. Aliases are globally unique, set at creation time, and work with custom domains and signed URLs.

Optional CDN slugs for storage files

Stored files can now have an optional cdnSlug for readable CDN paths:
PATCH /api/files/{id}
{ "cdnSlug": "hero-summer" }
Embed https://cdn.convertly.sh/{alias}/hero-summer?w=1200 instead of the UUID. Slugs are optional, unique per workspace, and UUID URLs keep working when a slug is set. Folders are not part of the slug path yet — use origin sources for multi-segment paths today.

Documentation