Storage

Sign file URL

Creates a signed URL that grants temporary access to a fal CDN file, regardless of its ACL. Useful for sharing access-restricted files.

The signature is valid for expiration_seconds (up to 7 days).

Authentication: Required. The API key must have the assets:read permission.

post/storage/files/sign

Query parameters

urlstring uri required

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

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

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

expiration_secondsinteger required

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

{
  "expiration_seconds": 3600
}

Signed URL granting temporary access

signed_urlstring required

URL with an embedded signature granting temporary access

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

No recorded changes to this endpoint across all 2 revisions of this API.