Storage

Set file ACL

Replaces the Access Control List of 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 may be specified by nickname or user ID. Setting default to allow with no rules makes the file public; forbid or hide restricts it to the rules you provide.

Rules referencing users that do not exist are dropped. The response reflects the ACL actually applied, so verify it contains the rules you sent.

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

put/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.

Request body

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

Fallback decision when no user-specific rule matches

Example request

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

Response

ACL applied to 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.