Storage

Get storage settings

Returns the account-level storage lifecycle settings applied to newly uploaded fal CDN files:

  • expiration_duration_seconds: how long files live before being automatically deleted (null disables auto-expiration).
  • initial_acl: the default ACL applied to new uploads (null means the system default, which is public).

Both fields are null when the account has never saved settings.

Authentication: Required. The API key must have the account:settings:read permission.

get/storage/settings

Response

Current storage settings

expiration_duration_secondsinteger nullable required

Seconds after which newly uploaded files automatically expire, or null if auto-expiration is disabled

Example response

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

Changes

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