# STORAGE_ALMOST_FULL

**What it means.** This app has used most of the file space its plan includes.

**What to do.** Nothing is refused yet. Delete files the app no longer needs, or move to a plan with more room — Personal includes 10 GB for each app, Family 50 GB and Community 200 GB — before it fills up. Tell the person: only they can change the plan.

- HTTP status: 200
- Retryable after applying the fix: yes

Every failure from the CLI or an MCP tool has this shape:

```json
{
  "ok": false,
  "code": "STORAGE_ALMOST_FULL",
  "message": "This app has used most of the file space its plan includes.",
  "fix": "Nothing is refused yet. Delete files the app no longer needs, or move to a plan with more room — Personal includes 10 GB for each app, Family 50 GB and Community 200 GB — before it fills up. Tell the person: only they can change the plan.",
  "file": "<where to edit, when known>",
  "retryable": true,
  "docs": "https://docs.uarpie.app/errors/STORAGE_ALMOST_FULL"
}
```

Apply `fix` (edit `file` when it is given), then run the same command again.
