Asset URL types

Smooth Bundle URLs identify the owner, project, optional release pointer and asset path. Use this page as the canonical reference when choosing a URL format.

Continuous project URL
https://cdn.smoothbundle.com/<user-slug>/<project-slug>/<asset-path>

Mutability

Mutable stable path

Cache behavior

Uses delivery cache headers for the current asset at that path.

Recommended use

CMS media, folder sync, current asset libraries and simple website assets.

Version URL
https://cdn.smoothbundle.com/<user-slug>/<project-slug>/<version>/<asset-path>

Mutability

Pinned to the selected version.

Cache behavior

Recommended when consumers must keep one exact release reference.

Recommended use

App releases, CI/CD output, design systems and versioned frontend bundles.

Latest URL
https://cdn.smoothbundle.com/<user-slug>/<project-slug>/latest/<asset-path>

Mutability

Follows the project latest pointer.

Cache behavior

Useful when consumers should move with the active version selected in Smooth Bundle.

Recommended use

Production integrations that intentionally follow the latest published release.

Tag URL
https://cdn.smoothbundle.com/<user-slug>/<project-slug>/<tag>/<asset-path>

Mutability

Follows the version assigned to a named tag.

Cache behavior

Useful for environment-style labels when the tag points to a version.

Recommended use

Labels such as staging, production or client-review when tags are configured.

Protected URL
https://cdn.smoothbundle.com/<user>/<project>/<version>/<asset>?t=<token>

Mutability

Matches the underlying asset URL type.

Cache behavior

Requires token or authenticated access. Avoid exposing tokens in public client code.

Recommended use

Controlled downloads, protected JSON outputs, client review files and premium assets.

Project subdomain URL
https://<project-subdomain>.smoothbundle.com/<version>/<asset-path>

Mutability

Matches the underlying project and version behavior.

Cache behavior

Available on paid plans for shorter project-specific Smooth Bundle URLs.

Recommended use

Production projects that need cleaner URLs than the shared cdn.smoothbundle.com form.