Skip to main content
Manage releases and promote apps to production via GitHub releases.

​
list

List releases for an app. 
floo releases list --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID

​
JSON output

{
  "success": true,
  "data": {
    "releases": [
      {
        "id": "r1a2b3c4-...",
        "tag": "v1.2.0",
        "commit_sha": "abc1234",
        "promoted_by": "you@example.com",
        "deploy_id": "d5e6f7g8-...",
        "created_at": "2026-03-01T14:00:00Z"
      }
    ]
  }
}

​
show

Show details for a specific release (tag, commit, promoted by, deploy ID, image digest). 
floo releases show r1a2b3c4 --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID

​
JSON output

{
  "success": true,
  "data": {
    "id": "r1a2b3c4-...",
    "tag": "v1.2.0",
    "commit_sha": "abc1234",
    "promoted_by": "you@example.com",
    "deploy_id": "d5e6f7g8-...",
    "image_digest": "sha256:abcdef123456...",
    "created_at": "2026-03-01T14:00:00Z"
  }
}

​
promote

Promote an app to production by creating a GitHub release. 
floo releases promote --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID
--tag TAGRelease tag (auto-generated if omitted, e.g., v1.2.1)

​
Examples

# Promote with auto-generated tag
floo releases promote --app my-app

# Promote with explicit tag
floo releases promote --app my-app --tag v2.0.0

# Agent workflow: promote and extract tag
floo releases promote --app my-app --json 2>/dev/null | jq -r '.data.tag'

​
JSON output

{
  "success": true,
  "data": {
    "id": "r9a8b7c6-...",
    "tag": "v1.2.1",
    "commit_sha": "def5678",
    "deploy_id": "d1e2f3g4-...",
    "release_url": "https://github.com/you/my-app/releases/tag/v1.2.1"
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
APP_NOT_FOUNDNo app with that name or ID
GITHUB_NOT_CONNECTEDConnect a GitHub repo first with floo apps github connect
NO_DEV_DEPLOYDeploy to dev first with floo deploy before promoting
RELEASE_TAG_EXISTSA release with that tag already exists. Use a different --tag
RELEASE_NOT_FOUNDNo release with that ID