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 — documented in this section
`/v1/public/*`	Unauthenticated — bootstrap, routing, TLS, branding (rate-limited)
`/v1/admin/*`	Groundfloor staff only — not published in public docs

Most pillar endpoints live under:

/v1/workspaces/{workspace_id}/…

See Shell API reference for federated-app-oriented examples, and Coderunners for the deploy path.

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.