The Hoody Daemon is a local process supervisor built on supervisord. It manages user-registered daemon programs and short-lived ephemeral quick-start programs on the host where it runs. The daemon exposes a REST API under the /api/v1/daemon/ prefix that lets you register programs, control their lifecycle, and inspect their status and logs.

The daemon is scoped to program supervision only. It does not orchestrate agents, manage containers, or expose a workspaces resource — those are separate namespaces on the Hoody platform.

Capabilities

Endpoints are grouped by capability: programs (management), control (lifecycle actions), status (monitoring), quick-start (ephemeral programs), and health (liveness).

Program Management

Register, inspect, edit, remove, and reset custom daemon programs with supervisord.

List programs and view details →

Program Control

Enable, disable, start, and stop a registered program by ID.

Control program lifecycle →

Status & Monitoring

Read program status and stream program logs from supervisord.

Monitor programs →

Endpoint paths

All daemon endpoints live under the /api/v1/daemon/ prefix:

Group	Path prefix
Programs (management)	/api/v1/daemon/programs
Quick-start (ephemeral)	/api/v1/daemon/quick-start
Status	/api/v1/daemon/status
Health	/api/v1/daemon/health

Lifecycle control actions for a registered program live under /api/v1/daemon/programs/{id}/enable, /disable, /start, and /stop.

Authentication

All daemon endpoints require the standard platform API key, passed as a Bearer token in the Authorization header: Authorization: Bearer <token>. See the Authentication guide for how to obtain a key.

Note

The health endpoint (GET /api/v1/daemon/health) is unauthenticated and always returns HTTP 200 when the daemon process is reachable. It is intended for liveness probes and should not be used to verify credentials.

Caution

The daemon does not mint its own bearer tokens. It accepts the platform API key only. Do not configure a separate daemon-specific token mechanism.

When to use the daemon API

Use the daemon API when you need to:

• Register a long-running custom program with supervisord so it survives between Hoody sessions.
• Start, stop, enable, or disable a registered program from another service or script.
• Launch a short-lived custom program (quick-start) for an ad-hoc task.
• Read program status or stream logs from supervisord for diagnostics.
• Probe daemon liveness from a health-check system.