Storage

Update storage settings

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. Sending an empty JSON object {} clears all settings. To change a single setting, first GET the current settings and PUT the full object back with only that field changed.

A request whose body is not valid JSON (including a zero-length body) or whose Content-Type is not application/json is rejected with a 400 validation_error and the stored settings are unchanged.

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.

put/storage/settings

Request body

expiration_duration_secondsinteger nullable

Seconds after which newly uploaded files automatically expire and are deleted. Null disables auto-expiration.

Example request

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

Response

Storage settings after the update

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.