FAfal
Storage

Sign file URL

Changed on

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.

Required permissions: assets:read. Key presets that include them: API, SERVERLESS, READONLY, FULL. See key permissions.

post/storage/files/sign

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/storage/files/sign
  • Auth
    API key in header Authorization

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

Request body

expiration_secondsinteger required

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

Example request

{
  "expiration_seconds": 3600
}

Response

Signed URL granting temporary access

signed_urlstring required

URL with an embedded signature granting temporary access

Example response

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

Changes

  • 479db2f9dcd6Revision changes
    • info

      the endpoint scheme security readonlyApiKey was added to the API

    • info

      the endpoint scheme security apiKey was removed from the API