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.

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

GET

storage

settings

Get storage settings

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

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

Key on the READONLY preset, or any key whose permissions include the ones this API lists. Prefix it 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

⌘I

Get storage settings

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

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"
  }
}