# API Reference

REST API reference for the Amfelt platform, generated from its OpenAPI specification.

- [account](/docs/reference/api/account/index.md): The authenticated user's own account and organization memberships.
- [advise](/docs/reference/api/advise/index.md): LLM-backed advisor — the agent-callable action plus admin config and metering.
- [agent](/docs/reference/api/agent/index.md): Registered Amfelt agents and their approval lifecycle.
- [agent-extras](/docs/reference/api/agent-extras/index.md): Agent registration, invites, key rotation, security posture, and the registration-event audit log — the agent surface beyond the lifecycle core.
- [agent-release](/docs/reference/api/agent-release/index.md): Released builds of the Amfelt agent.
- [agent-versions](/docs/reference/api/agent-versions/index.md): The organization's agent version policy per DTAP environment: follow the newest release, or hold a pinned version that moves by promotion.
- [approvals](/docs/reference/api/approvals/index.md): Generic approval requests: a change that needs a second person waits here until it is approved, declined, or expires.
- [audit](/docs/reference/api/audit/index.md): The organization's audit log. Each record states who acted, what was done, to which class of governed object, and how it ended.
- [catalog](/docs/reference/api/catalog/index.md): Discovered ODCS data contracts for project catalog sources.
- [checkpoint](/docs/reference/api/checkpoint/index.md): Lifecycle checkpoints recorded during a job run.
- [health](/docs/reference/api/health/index.md): Liveness probe. Returns immediately with build information and uptime — no database, no auth.
- [orgs](/docs/reference/api/orgs/index.md): Self-service organization creation, membership, and invites.
- [plugin](/docs/reference/api/plugin/index.md): Plugins available for the Amfelt client.
- [projects](/docs/reference/api/projects/index.md): Project lifecycle within a tenant.
- [run](/docs/reference/api/run/index.md): Job-run history, reports, and tasks persisted by the Amfelt agent.
- [secret](/docs/reference/api/secret/index.md): Vault-backed secret storage and rotation.
- [telemetry](/docs/reference/api/telemetry/index.md): Agent telemetry firehose. Agents POST run/task lifecycle events to feed the in-memory ring buffer that backs the live SSE stream; admins can purge the cache to reclaim memory.