Storage

Get file ACL

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.

get/storage/files/acl

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.

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

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