Skip to content

Get App Runtime

GET
/apps/{app_id}/runtime

Can this app be built and run yet, and if not, what is missing (M9 J9).

ANSWERS FROM THE CONTROL PLANE, AND SAYS SO. It reports what graph8 has recorded: a bound source, an assigned hostname, declared secrets, the last deployment’s state. The serving half — namespace provisioner, registry credentials, and the deployed-image rollout — now EXISTS as control-plane code (#22301), so this no longer blocks on it unconditionally. What it still checks is whether that code is CONFIGURED in this environment (_unset_serving_runtime_vars): reporting ready: true with the templates or registry credentials unset would be the most expensive kind of wrong, because a builder would push and wait for something nothing can serve.

blockers is the field that matters. An agent driving a build needs to know WHY it cannot proceed; a bare ready: false sends it guessing, and guessing against a deploy pipeline is how you get retry loops.

Deliberately cheap: three reads the caller could make themselves across GET /apps/{id}, /secrets and /deployments. It exists so the answer is computed in one place, because “am I ready” is a judgement about which prerequisites matter, and three clients would each get it slightly wrong.

Authorizations

Parameters

Path Parameters

app_id
required
string

Header Parameters

X-Org-Id
Any of:
string

Responses

200

Successful Response

object
data
required

Whether an app is ready to be built and run, and what is missing (J9).

A READINESS REPORT, not a promise. It answers from what the control plane knows: is a source bound, is a hostname assigned, are secrets declared, what did the last deployment do. It does NOT claim the cluster side is ready, because the namespace provisioner, the image registry and the runtime objects are separate work and none of them exist yet.

blockers is the useful field and it is deliberately explicit. An agent driving a build needs to know WHY it cannot proceed, and a bare ready: false sends it guessing.

object
app_id
required
string
blockers

Each unmet prerequisite, named. Empty means ready.

Array<string>
hostname_assigned
required
boolean
latest_deployment_status
Any of:
string
ready
required

True only when nothing in blockers remains. False is the normal answer today.

boolean
secrets_declared
required
integer
source_bound
required
boolean
pagination
Any of:
object
has_next
required

Whether there are more pages

boolean
limit
required

Items per page

integer
next_cursor
Any of:
string
notes
Any of:
Array<string>
page
required

Current page number (1-indexed)

integer
total
required

Total number of items

integer
total_available
Any of:
integer
total_is_lower_bound
Any of:
boolean

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string