---
title: "Get storage settings"
method: GET
path: "/storage/settings"
tags: ["Storage"]
---

# Get storage settings

`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.

## Response `200`

Current storage settings

- object — Account-level storage lifecycle settings
  - `expiration_duration_seconds` integer, nullable, required — Seconds after which newly uploaded files automatically expire, or null if auto-expiration is disabled
  - `initial_acl` object, nullable, required — Default ACL applied to newly uploaded files, or null if the system default (public) is used
    - `default` 'allow' | 'forbid' | 'hide', required — Fallback decision when no user-specific rule matches
    - `rules` object[], required — User-specific overrides to the default decision. Users are returned as nicknames where possible.
      - `user` string, required — User nickname or user ID the rule applies to
      - `decision` 'allow' | 'forbid' | 'hide', required — Access decision applied to this user

## Other responses

- `401` — Authentication required
- `403` — Access denied
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/fal/apis/platform-apis.md) · [All operations](https://skmtc.dev/fal/apis/platform-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fal/platform-apis/revisions/0c7dabf80b00/schema)