Skip to content
Log in
Developer API
Get your keyGet a key

Reference · Files

POST/share-links

A lasting public link to one of the account’s files

Make a permanent public link (https://vessero.com/s/…) to one of the person’s own Vessero files — something made in Vessero or uploaded to it — for a website, a store page, or anywhere a link has to keep working. The file links create tools return last about a week; this one stays public until it is turned off, which the person can ask you to do at any time (DELETE /api/v1/share-links/{id}; GET /api/v1/share-links lists the links that are on). Anyone with the link can open the file, so make one only for a file the person means to publish. Asking again for the same file returns the same link. Free: it costs no credits. Pasted into a chat or a post (WhatsApp, iMessage, Slack, X, LinkedIn…), a link to a picture previews as that picture.

Key needs
create · Make things and spend credits
Spends
Nothing
Answers
Data
Request
curl -X POST https://vessero.com/api/v1/share-links \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "text"
  }'

Body

  • keystringrequiredThe file: its storage key, as POST /api/v1/files returns it (e.g. ai-video/uploads/…/….png), or the Vessero file link (…/f/…) a create tool or the library returned for it.

Answers

  • 200okWhat it did, as data.
  • 400invalid_requestA field is missing or not accepted: see details.
  • 404not_foundNot found on this account.
  • 403feature_unavailableThe studio this needs is switched off for the account right now.
Next in FilesGET/share-links