Stack API
Routers
Section titled “Routers”router→ prefix/api/method(tags: stack)
Hand-maintained notes against modules/stack/router.go. Route inventory (generated): routes.md. Response models (generated): response-models/stack.md.
Lifecycle verbs that install / uninstall / update / scale a stack live in the
appmodule (shc.stack.install,shc.stack.uninstall,shc.stack.update,shc.stack.scale,shc.stack.status). Log streaming (shc.stack.logs.stream) lives in thelogsmodule;shc.stack.movelives in theclonemodule.
| Method | Path | Permission |
|---|---|---|
GET | /api/method/shc.stack.config | — |
GET | /api/method/shc.stack.dry_run | — |
GET | /api/method/shc.stack.inspect | — |
GET | /api/method/shc.stack.logs | — |
POST | /api/method/shc.stack.exec | — |
POST | /api/method/shc.stack.restart | — |
POST | /api/method/shc.stack.start | — |
POST | /api/method/shc.stack.stop | — |
POST | /api/method/shc.container.restart | — |
GET /api/method/shc.stack.config
Section titled “GET /api/method/shc.stack.config”- source:
modules/stack/router.go
GET /api/method/shc.stack.dry_run
Section titled “GET /api/method/shc.stack.dry_run”- summary: render the compose/plan for a stack without applying it.
- source:
modules/stack/router.go
GET /api/method/shc.stack.inspect
Section titled “GET /api/method/shc.stack.inspect”- summary: one-shot bundle for the HUD Inspect panel and
shc inspect. - source:
modules/stack/router.go— handler calls the daemon-wired Inspector atdaemon/services_seams_stack.go
StackInspectResponse is a one-shot bundle covering everything the HUD’s
Inspect panel and the shc inspect CLI need without follow-up calls.
Field inventory (generated): response-models/payload-shapes.md.
Semantics the generated table can’t carry: composed_config is the parsed
docker compose config --format json output, best-effort with a 5s
timeout (absent when compose can’t resolve); containers holds one entry
per container under the compose project label with Health enriched from
the metrics stats cache; health_rollup summarises containers[].Health
as healthy / starting / unhealthy / unknown / "".
GET /api/method/shc.stack.logs
Section titled “GET /api/method/shc.stack.logs”- query params:
stack_name,environment,service,tail,timestamps - source:
modules/stack/router.go
POST /api/method/shc.stack.exec
Section titled “POST /api/method/shc.stack.exec”- source:
modules/stack/router.go
POST /api/method/shc.stack.restart
Section titled “POST /api/method/shc.stack.restart”- source:
modules/stack/router.go
POST /api/method/shc.stack.start
Section titled “POST /api/method/shc.stack.start”- source:
modules/stack/router.go
POST /api/method/shc.stack.stop
Section titled “POST /api/method/shc.stack.stop”- source:
modules/stack/router.go
POST /api/method/shc.container.restart
Section titled “POST /api/method/shc.container.restart”- summary: restart a single container within a stack.
- source:
modules/stack/router.go