Skip to content

Share Management

Slink uses a privacy-first share model: every share is fully private by default and only becomes accessible to whoever holds the link. The Share Management page is where you list, publish, and configure access controls for all of your shares.

Navigate to /shares while logged in. The page lists every share you own across both images and collections, with filters for type, expiration, and password protection.

Each row exposes inline controls that map directly to the Shares API:

  • Publish / Unpublish — Toggles whether the link is reachable. Unpublished shares return 404 to anyone who tries the URL.
  • Password — Sets, updates, or clears a password on the share. Hashed at rest; unlocking issues a short-lived cookie so the viewer is not re-prompted on every request.
  • Expiration — Sets or clears an expiration timestamp. Once it passes, the share auto-revokes.

From an image’s detail page, use the Copy Link action to create and copy a share. The share is considered published the moment its link is copied from the UI: Slink creates (or reuses) the underlying share record and immediately publishes it in a single step before placing the URL on your clipboard.

If you create a share programmatically via the API, it starts unpublished so you can set a password or expiration before exposing the link, then publish it explicitly via PUT /api/share/{id}/publish.

Collection shares behave slightly differently: they are auto-published on creation, since most collection-share workflows expect the link to work immediately.

The page supports filtering by:

  • Type — Image or Collection
  • Expiration — Has expiry, Expired, No expiry
  • Password protection — Password protected, No password

Free-text search matches against the underlying shareable’s name.

The release that introduced this model ships an automatic migration that:

  • Converts existing legacy share records to the new Share aggregate.
  • Creates missing share records for images that were already publicly accessible by link, so existing URLs keep working.

Shares carrying custom transformation parameters (width, height, crop, format, filter) are not auto-migrated and need to be re-created from the image detail page if you want the variant link preserved.