Public Links

generatePublicLink

Generate a public link to share a private file externally.

The generated link:

  • Is permanent until explicitly revoked
  • Includes the filename for user-friendly URLs
  • Does not require authentication to access
  • Redirects to a signed download URL when accessed

Use case: Share invoices, contracts, or documents with external parties who don't have epilot accounts.

post/v1/files/{id}/public/links

Request

  • Base URL
    https://file.sls.epilot.io
  • URL
    https://file.sls.epilot.io/v1/files/{id}/public/links
  • Auth
    • HTTP bearer
    • or API key in cookie token

Path parameters

string required

Empty string (used when file ID not yet assigned)

OR
string uuid required

Valid UUID v4

The UUID of the file entity to share

Response

Public link generated successfully

string required

The public URL that can be shared externally

Changes

No recorded changes to this operation across all 10 revisions of this API.