Skip to main content
Manage your deployed apps.

​
list

List all apps on your account. 
floo apps list

Your apps:
  Name          Status  Runtime   URL
  my-app        live    nodejs    https://my-app.on.getfloo.com
  api-service   live    python    https://api-service.on.getfloo.com
  landing       stopped static    https://landing.on.getfloo.com

​
Flags

FlagDescriptionDefault
--page NPage number1
--per-page NResults per page50

​
JSON output

{
  "success": true,
  "data": {
    "apps": [
      {
        "id": "a1b2c3d4-...",
        "name": "my-app",
        "status": "live",
        "url": "https://my-app.on.getfloo.com",
        "runtime": "nodejs",
        "created_at": "2026-02-18T10:30:00Z"
      }
    ]
  }
}

​
show

Show details for a specific app. Accepts app name or UUID. 
floo apps show my-app

App: my-app
  Status:   live
  URL:      https://my-app.on.getfloo.com
  Runtime:  nodejs (Next.js)
  Created:  2026-02-18 10:30

​
JSON output

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-...",
    "name": "my-app",
    "status": "live",
    "url": "https://my-app.on.getfloo.com",
    "runtime": "nodejs",
    "created_at": "2026-02-18T10:30:00Z"
  }
}

​
delete

Delete an app and tear down its infrastructure. 
floo apps delete my-app

This permanently deletes my-app and all its data. Type the app name to confirm: my-app
Deleted my-app
Deleting an app is tier-3 destructive. Interactive mode makes you type the app name to confirm; there is no --force or --yes shortcut.

​
Flags

FlagDescription
--yes-i-know-this-destroys-dataSkip the name-confirmation prompt. Required in non-interactive contexts (CI, --json, pipes). Deliberately verbose — destroying an app and its data must be an explicit, acknowledged decision.

​
JSON output

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-..."
  }
}

​
password

Show the shared password for a password-protected app. 
floo apps password my-app

​
invite

Grant a user access to an app by email. Use this for accounts-mode apps when you want to let specific people in without opening the app to a whole domain. 
floo apps invite teammate@acme.com --app my-app

​
Arguments

ArgumentDescription
EMAILEmail address to invite

​
Flags

FlagDescription
--app APPApp name or UUID (inferred from config if omitted)
The invited user shows up in the app’s Users tab in the dashboard. For org membership (who can operate the app) versus app access (who can sign in), see Team Access.

​
github

Manage GitHub integration for auto-deploy on push. See the full reference at GitHub Integration. 
floo apps github connect owner/repo --app my-app
floo apps github disconnect --app my-app
floo apps github status --app my-app

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
APP_NOT_FOUNDNo app with that name or ID. Check with floo apps list