Skip to main content
GET
List Deploys

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

page
integer
default:1
Required range: x >= 1
per_page
integer
default:20
Required range: 1 <= x <= 100
limit
integer | null
Required range: 1 <= x <= 100
cursor
string | null

Opaque pagination cursor returned as next_cursor. Existing page/per_page parameters remain supported for older clients.

service_id
string<uuid> | null
env
enum<string> | null

Enumerate the persisted development, production, and preview environment names.

Available options:
dev,
prod,
preview
commit_sha
string | null

Full 40-character lowercase Git commit SHA (git rev-parse HEAD). Returns the deploys built from exactly that commit; when none exists, the deploy a coalesced push of it was folded into (its coalesced_commits lists the SHA). After git push, an empty page means the push has not registered yet: retry shortly, then GET the deploy with wait until status is terminal.

Pattern: ^[0-9a-f]{40}$
include_build_logs
boolean
default:false

When true, includes build_logs in every deploy row. The default is false so deploy history stays compact and agent-safe. Note: null is ambiguous when false — it may mean "no logs were captured" (the underlying column is null) or "logs exist but this query suppressed them". Fetch GET /v1/apps/{app_id}/deploys/{deploy_id} for the canonical per-deploy build_logs value.

Response

Successful Response

Paginated response for listing deploys.

deploys
DeployResponse · object[]
required
total
integer
required
page
integer
required
per_page
integer
required
limit
integer
required
next_cursor
string | null
has_more
boolean
default:false