Groundfloor Docs

LLM Gateway API

Model catalog, usage rollup, and workspace virtual keys via LiteLLM.

Base path: /v1/workspaces/{workspace_id}/llm

Inference goes to LiteLLM directly — Control Plane is not in the token data path. Store the virtual key in Secrets (for example LITELLM_API_KEY).

See also: Customer Portal — LLM Gateway

Models

GET /v1/workspaces/{workspace_id}/llm/models

Returns the Groundfloor catalog plus BYO models when provider keys exist in workspace secrets.

Permission: read

Usage

GET /v1/workspaces/{workspace_id}/llm/usage?since_seconds=604800&limit=100
QueryDefaultNotes
since_seconds86400Lookback window
limit—Max rows

Permission: read

Virtual key

POST /v1/workspaces/{workspace_id}/llm/virtual-key

Mints or rotates the workspace virtual key. The plaintext key is returned once.

Permission: administer

Feature Flags API

Upsert per-environment typed flags and promote them across environments.

Data Vault API

Query and manage customer data collections via the Control Plane Dataplane proxy.