# Kreuzberg Cloud Platform API

This is the dashboard/management API used by the Kreuzberg Cloud web app. Most agents and integrations should use the [Extraction API](https://kreuzberg.dev/llms/api.md) instead — this surface is for users who want to administer projects, members, or billing programmatically.

The full OpenAPI spec for this surface is committed in the frontend repository as `frontend/openapi-backend.yaml`; live docs at <https://docs.kreuzberg.dev/>.

## Base URL

The management API is served at the dashboard backend hostname (e.g. `https://app.kreuzberg.dev`), distinct from the extraction API at `https://api.kreuzberg.dev`. The exact production URL is discoverable from the dashboard at <https://kreuzberg.dev/dashboard>.

## Authentication

Bearer JWT obtained via `POST /auth/login` with an OIDC ID token. Sessions are short-lived; programmatic clients should prefer extraction-API keys for data-plane work.

## Resource surface

- **Auth** — `POST /auth/login` (OIDC ID token → JWT), `DELETE /auth/account`
- **Health** — `GET /healthz`, `GET /readyz`
- **Projects** — CRUD, analytics, quota, settings
- **API keys** — create, list, revoke, regenerate (these keys authenticate calls to the Extraction API)
- **Members and invitations** — invite by email, role management, accept invitations via token
- **Webhooks** — register endpoints, list deliveries
- **Billing** — quota status, Stripe Checkout session, Stripe Customer Portal session

## See also

- [Extraction API](https://kreuzberg.dev/llms/api.md) — the data-plane API for actual document processing
- [Pricing](https://kreuzberg.dev/llms/pricing.md)
- [Full documentation](https://docs.kreuzberg.dev/)