Skip to main content
GET
/
storage
/
files
/
acl
Get file ACL
curl --request GET \
  --url https://api.fal.ai/v1/storage/files/acl \
  --header 'Authorization: <api-key>'
{
  "default": "forbid",
  "rules": [
    {
      "user": "my-teammate",
      "decision": "allow"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key must be prefixed 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"

Response

Current ACL of the file

Access Control List currently applied to the file

​
default
enum<string>
required

Fallback decision when no user-specific rule matches

Available options:
allow,
forbid,
hide
Example:

"allow"

​
rules
object[]
required

User-specific overrides to the default decision. Users are returned as nicknames where possible.