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

Get storage settings

curl --request GET \
  --url https://api.fal.ai/v1/storage/settings \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fal.ai/v1/storage/settings"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/storage/settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}

Authorizations

Authorization

string

header

required

API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_API_KEY

Response

Current storage settings

Account-level storage lifecycle settings

expiration_duration_seconds

integer | null

required

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

Example:

86400

initial_acl

object | null

required

Default ACL applied to newly uploaded files, or null if the system default (public) is used

Show child attributes

Update Replaces the account-level storage lifecycle settings applied to newly uploaded fal CDN files. Omitted or null fields are cleared (reset to the system default), so always send the full desired configuration. ACL rules referencing users that do not exist are dropped. The response reflects the settings actually saved, so verify it contains the rules you sent. These are the same settings that the per-request `X-Fal-Object-Lifecycle-Preference` header overrides on individual requests. **Authentication:** Required. The API key must have the `account:settings:write` permission.

⌘I

Get storage settings

curl --request GET \
  --url https://api.fal.ai/v1/storage/settings \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.fal.ai/v1/storage/settings"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.fal.ai/v1/storage/settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

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

{
  "error": {
    "type": "authorization_error",
    "message": "Authentication required"
  }
}

{
  "error": {
    "type": "authorization_error",
    "message": "Access denied"
  }
}

{
  "error": {
    "type": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "type": "server_error",
    "message": "An unexpected error occurred"
  }
}