Skip to content
These pages describe Stewart 1.x. Read the docs for the latest release, and how to upgrade.

Admin API reference

The admin port is off by default. Every request needs Authorization: Bearer <token> with http.admin.token. Status and control shows how to turn it on, and the answers and status codes. Prometheus can scrape the metrics port instead, which needs no admin token.

Method Path Does
GET, HEAD /api/apps Lists every app with its state and pause
GET, HEAD /api/apps/{id} Shows one app
POST /api/apps/{id}/pause Pauses an app, like stewart app:pause
POST /api/apps/{id}/resume Resumes an app, like stewart app:resume
POST /api/apps/{id}/reset Forgets a stored pause or resume, like stewart app:reset
POST /api/workers/{id}/restart Restarts a worker, like stewart worker:restart
POST /api/reload Checks the project, then restarts every worker on the current code, like stewart reload
GET, HEAD /metrics Prometheus metrics; see the metrics reference