API Reference

REST API for the Control Plane — authentication, route groups, and endpoint documentation.

Programmatic access to Groundfloor goes through the Control Plane REST API.

Start here

Prefix	Audience
`/v1/*`	Customer — account-scoped endpoints
`/v1/admin/*`	Operator — Groundfloor staff
`/v1/public/*`	Unauthenticated — bootstrap, routing, TLS (rate-limited)

Most pillar endpoints live under:

/v1/workspaces/{workspace_id}/…

See Shell API reference for endpoints used by federated apps.

Architecture Decisions

Summaries of key Control Plane architectural decisions — full ADRs remain in the product repository.

API Introduction

Base URLs, authentication, error format, and route groups for the Control Plane REST API.