Storage

Get storage settings

Changed on

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.

Required permissions: account:settings:read. Key presets that include them: API, SERVERLESS, DEPLOY, COMPUTE, BILLING, READONLY, FULL. See key permissions.

get/storage/settings

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/storage/settings
  • Auth
    API key in header Authorization

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

    • info

      the endpoint scheme security readonlyApiKey was added to the API

    • info

      the endpoint scheme security apiKey was removed from the API