Skip to content

List running containers for an app

GET
/apps/{slug}/services
slug
required
string

App slug (lowercase, dash-separated).

Service status.

Array<object>

Aggregated status for one compose service across all replicas.

object
service
string
state

Worst-case state across replicas (running, restarting, stopped, …).

string
Example
running
health
string
Example
healthy
replicas

Number of running containers for this service.

integer
scalable

Whether the service is eligible for replica scaling.

boolean
scale_reason

When scalable is false, explains why (e.g. ‘stateful image (postgres)’).

string