REST API
The daemon exposes a REST API that the dashboard and external HTTP clients use
to control Stackie. The API server listens on 127.0.0.1:PORT — configure the
port in ~/.stackie/stackie.yaml under api.port.
Endpoint Groups
| Prefix | Description |
|---|---|
/api/auth | Login, logout, session status |
/api/blocks | Block list, pull, install |
/api/containers | Sandbox lifecycle (create, start, stop) |
/api/downloads | Download progress and history |
/api/events | SSE lifecycle event stream |
/api/exec | Command execution inside sandboxes |
/api/network | Port allocation and forwarding |
/api/packages | Installed package queries |
/api/secrets | Secret value resolution |
/api/settings | Read/write user settings |
/api/stacks | Stack definition queries |
/api/update | Self-update status and trigger |
/api/volumes | Volume management |
/api/system | Daemon info and health |
/api/mocker | Docker image alias resolution (Docker Engine API compatibility) |
Authentication
Most endpoints require a valid session cookie or Authorization header.
/api/auth/login and /api/system/health are public.