REST API overview

Reference generated from the checked-in contract. The frozen machine-readable spec for this build is at openapi.json; the interactive explorer lives at https://entherium.duckdns.org:8443/reference.

Calling the API

• Base URL: https://entherium.duckdns.org:8443; every path below is relative to it.
• Auth: all data endpoints need Authorization: Bearer <token>. Humans log in with the OAuth2 password flow (POST /api/v1/auth/login); agents use a scoped agent token issued by the platform owner — see Authentication. Without a token only these answer: /healthz, /status.json, /api/status.json, /api/ (the machine map), /openapi.json, /reference, /redoc, /llms.txt, /mcp-info, the docs MCP at /mcp/docs/ and this portal.
• Errors: JSON {"detail": "<human-readable>"}; some endpoints add a machine code. Full list: Errors reference.
• Retries: the task and ticket intake endpoints honour an Idempotency-Key header (UUID); see Limits.
• Groups vs domains: this reference groups operations by contract tag; the MCP discovery map (list_domains, GET /api/) names 28 capability domains — a different axis (a domain may span several tags or have no public operation), so the counts differ on purpose.

Group	Operations
agent	2
analytics	4
architecture	2
auth	6
chat	1
cloudflare	6
cockpit	4
comments	5
cycles	4
docs	3
entities	12
errors	1
health	3
instances	8
integrations	3
lifecycles	6
localizations	1
metamodel	2
metering	4
ops	3
publish	3
runs	17
specs	6
sse	6
tasks	5
tickets	3