Skip to main content
GET
Get App Status

Authorizations

Authorization
string
header
required

A floo_ API key.

Headers

X-Floo-Org-Id
string<uuid>

Organization to act in; defaults to the one joined most recently.

Path Parameters

app_id
string<uuid>
required

Query Parameters

commit
string | null

Full 40-character Git commit SHA (git rev-parse HEAD). The status says whether this commit is live on dev, or why not. Leave it out for the newest dev deploy.

Pattern: ^[0-9a-f]{40}$

Response

Successful Response

One read that answers "is my change live on dev?" and names the next step.

deploy is the dev deploy of commit, or the newest dev deploy when no commit was asked about. With no deploy, last_push says what floo did with the last push it saw, so a push that did not deploy is explained.

app
string
required
source
AppSource · object | null
required

Where the app's code lives: a push to branch of repo deploys dev. Null when the app has no code source yet.

commit
string | null
required

The commit asked about, if any.

live
boolean
required

True when deploy is the deploy dev serves now.

summary
string
required

One sentence on where the commit or app stands.

next_step
string | null
required

What to do next; null when nothing is needed.

next
NextStep · object | null
required

next_step as the call to make from the CLI (cli), raw HTTP (api) or an MCP client (mcp). Null when nothing is needed, or when the step is a person's to take.

deploy
DeployResponse · object | null
required

Response for a single deploy.

serving
ServingDeploy · object | null
required

The dev deploy serving traffic now.

last_push
GitHubLastPush · object | null
required

The last push webhook for this app and what floo did with it.