API Reference

The AGH daemon ships a single HTTP surface under /api. This reference is built from openapi/agh.json at every site build, so each request and response schema below matches the binary you are running.

The CLI and the HTTP API operate the same daemon state. Use the CLI reference for end-to-end recipes; use the per-tag pages here when you need request bodies, response schemas, status codes, or SSE event shapes.

Recommended Entry Points

Automating session work

1. Sessions — POST /api/sessions, POST /api/sessions/{id}/prompt, GET /api/sessions/{id}/events, GET /api/sessions/{id}/stream, POST /api/sessions/{id}/resume.
2. Agents — list and inspect resolved agent definitions.
3. Memory — read, write, search, and consolidate persistent context.

Building operational dashboards

1. Observe — global health, event stream, task dashboard.
2. Memory — health and redacted operation history.
3. Bridges — health snapshots and SSE updates.

Integrating runtime configuration

1. Settings — read and mutate daemon settings.
2. Vault — list metadata, write new refs, delete refs (no plaintext ever leaves the daemon).
3. Workspaces and Skills — register and inspect operator surfaces.

Managing extensible desired state

1. Resources — read and mutate desired-state objects.
2. Automation — jobs, triggers, runs.
3. Extensions — install, enable, disable, inspect extensions.