Skip to main content
POST
Sign file URL

Authorizations

Authorization
string
header
required

Key on the READONLY preset, or any key whose permissions include the ones this API lists. Prefix it with "Key ", e.g. Authorization: Key YOUR_API_KEY

Query Parameters

url
string<uri>
required

Full URL of the fal CDN file, as returned by the upload APIs (https://v3.fal.media/files/b//). Must not contain query parameters.

Example:

"https://v3.fal.media/files/b/0a1b2c3d/output.png"

Body

application/json

Signing options for the file URL

expiration_seconds
integer
required

How long the signed URL stays valid, in seconds (max 7 days)

Required range: 1 <= x <= 604800
Example:

3600

Response

Signed URL granting temporary access

Signed URL response

signed_url
string
required

URL with an embedded signature granting temporary access

Example:

"https://v3.fal.media/files/b/0a1b2c3d/output.png?identity=..."