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:

{
  "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.