Skip to main content
Manage services for a floo app. Apps can have multiple services (web, api, worker).

​
list

List all services for an app. 
floo services list --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID

​
JSON output

{
  "success": true,
  "data": {
    "services": [
      {
        "name": "web",
        "service_type": "web",
        "port": 3000,
        "status": "live",
        "ingress": "public"
      },
      {
        "name": "worker",
        "service_type": "worker",
        "port": null,
        "status": "live",
        "ingress": "internal"
      }
    ]
  }
}

​
info

Show details for a service (type, status, ingress, URL, port). Also works for floo-managed databases. 
floo services info web --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID

​
JSON output

{
  "success": true,
  "data": {
    "name": "web",
    "service_type": "web",
    "port": 3000,
    "status": "live",
    "ingress": "public",
    "url": "https://my-app-abc123.us-central1.run.app"
  }
}

​
add

Add a service to the project config (floo.app.toml). 
floo services add worker ./worker

​
Flags

FlagDescription
--port NPort the service listens on
--type web|api|workerService type
--ingress public|internalIngress mode
--env-file PATHPath to a .env file for this service

​
Examples

# Add a web service
floo services add api ./api --type api --port 8080 --ingress public

# Add a background worker
floo services add worker ./worker --type worker --ingress internal

# Add with env file
floo services add api ./api --port 8080 --env-file ./api/.env

# Agent workflow: add service and verify
floo services add api ./api --port 8080 --json 2>/dev/null | jq -r '.data.name'

​
JSON output

{
  "success": true,
  "data": {
    "name": "api",
    "path": "./api",
    "service_type": "api",
    "port": 8080,
    "ingress": "public"
  }
}

​
rm

Remove a service from the project config. 
floo services rm worker

​
Flags

FlagDescription
--delete-configAlso delete the service’s floo.service.toml

​
JSON output

{
  "success": true,
  "data": {
    "name": "worker",
    "config_deleted": false
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
SERVICE_NOT_FOUNDNo service with that name exists
DUPLICATE_SERVICEA service with that name already exists
NO_CONFIG_FOUNDNo floo.app.toml found in the project directory
INVALID_SERVICE_NAMEService name contains invalid characters