# API reference

> Every route of the LightHouse API (152 operations), generated from the control plane's OpenAPI document.

LightHouse’s HTTP API, served by the Atlantic Agentic Labs control plane. Each client’s portal is `https://<client>.atlanticagenticlabs.com`; every request is authenticated by Cloudflare Access (people) or a machine key, and scoped to one tenant by row-level security. Approvals and payments are people-only: a machine key is refused on every approving or paying route.

Generated from the OpenAPI document of the control plane (API 0.1.0); nothing on these pages is written by hand. Download it: [openapi.json](/openapi.json).

## Authentication

| Caller      | How                                                                                                                                           |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Person      | A person’s session: Cloudflare Access, MFA required.                                                                                          |
| Machine key | A per-client key `aalcp-...` (viewer or content_viewer), with the client’s Access service token at the edge. Never approves, decides or pays. |

## Groups

| Group                                                            | Operations |
| ---------------------------------------------------------------- | ---------- |
| [Read](/api/reference/read/)                                     | 55         |
| [Access and keys](/api/reference/access-and-keys/)               | 6          |
| [Assistant](/api/reference/assistant/)                           | 3          |
| [Billing](/api/reference/billing/)                               | 34         |
| [Branding](/api/reference/branding/)                             | 7          |
| [Content in place](/api/reference/content-in-place/)             | 2          |
| [Deployments](/api/reference/deployments/)                       | 3          |
| [Exports](/api/reference/exports/)                               | 3          |
| [Handler commands](/api/reference/handler-commands/)             | 8          |
| [Marketplace](/api/reference/marketplace/)                       | 9          |
| [People and preferences](/api/reference/people-and-preferences/) | 15         |
| [Savings and caching](/api/reference/savings-and-caching/)       | 7          |

Source: https://docs.atlanticagenticlabs.com/api/reference/