Skip to main content
POST
Get a short-lived link to a file

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
filename
string

The stored name of one of the caller's files (no folder separators). Give this or path.

path
string

The file's path, /uploads/<owner id>/<file name>. Give this or filename.

ttl
integer
default:60

How long the link works, in seconds.

Required range: 10 <= x <= 86400
purpose
enum<string>

preview when the link is only used to show the file in a preview. Such a link is not counted as a use of the file. Leave it out for a download or a link to share.

Available options:
preview

Response

The signed address

success
boolean
signedUrl
string

The path with its signature — add it to the site address to open the file.

hmac
string
expires
integer
path
string