Unbreakable URLs

Reshot provides two types of permanent URLs:

Live URLs — Always show the latest approved version (for marketing sites)
Pinned URLs — Show a specific tagged version (for versioned documentation)

URL Types

Live URL (Always Latest)

Code

https://cdn.reshot.dev/v1/assets/[project-id]/[visual-key]

This URL always serves the latest approved version. When you approve a new version, the URL automatically serves the new content.

Use for: Marketing sites, blog posts, landing pages

Pinned URL (Specific Version)

Code

https://cdn.reshot.dev/v1/assets/[project-id]/[visual-key]?tag=v1.2

This URL is pinned to a specific version tag. Even when you publish new versions, this URL continues to serve the tagged version.

Use for: Versioned documentation, release notes, archived docs

Tagging Versions

When publishing, use the --tag flag to create a pinned version:

Terminal

reshot publish --tag v1.2

This creates a snapshot that can be referenced forever:

MARKDOWN

<!-- For v1.2 docs -->

![Login](https://cdn.reshot.dev/v1/assets/proj_123/login?tag=v1.2)

Visual URLs — Each visual in the explorer has a permanent CDN URL shown in its detail view

The Pointer Pattern

Unbreakable URLs are permanent links that act as "pointers." They never change, but the image they display updates automatically when you approve a new version.

URL Structure

Assets are served via our global CDN:

Code

https://cdn.reshot.dev/v1/assets/[project-id]/[visual-key]

Example

If you have a visual named "login-modal":

Code

https://cdn.reshot.dev/v1/assets/proj_123/login-modal

Today: Serves the v1.0 login screen
Tomorrow: You redesign and approve v2.0
Result: The exact same URL serves the v2.0 image

Your docs are instantly up to date with zero changes.

Embedding in Documentation

Use the permanent URL in your Markdown:

MARKDOWN

![Login Modal](https://cdn.reshot.dev/v1/assets/proj_123/login-modal)

Or in HTML:

HTML

<img
  src="https://cdn.reshot.dev/v1/assets/proj_123/login-modal"
  alt="Login Modal"
/>

Accessing Variants

If you capture multiple variations (Dark Mode, different languages), access them with query parameters:

Variant	URL
Default	`.../login-modal`
Dark Mode	`.../login-modal?context=dark`
German	`.../login-modal?context=de-DE`
Korean	`.../login-modal?context=ko-KR`

Benefits

No broken links: URLs never change
Zero maintenance: Approve in dashboard, docs update automatically
Version control: Roll back anytime
Variant support: Single URL, multiple contexts

Once you embed a Reshot URL in your documentation, you never need to touch it again. The image updates automatically when you approve changes.