FAfal
Storage

Get file ACL

Changed on

Returns the Access Control List currently applied to a fal CDN file.

The ACL consists of a default decision (allow, forbid, or hide) plus optional per-user rules that override the default. Rule users are returned as nicknames where possible.

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.

get/storage/files/acl

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/storage/files/acl
  • 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

Response

Current ACL of the file

default'allow' | 'forbid' | 'hide' required

Fallback decision when no user-specific rule matches

Example response

{
  "default": "allow",
  "rules": [
    {
      "user": "some-user",
      "decision": "allow"
    }
  ]
}

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