Shapes
WarmHub does not currently mount REST endpoints under /api/repos/:orgName/:repoName/shapes.
Use these supported surfaces instead:
| Task | Surface |
|---|---|
| Read repository data filtered by shape | GET /api/repos/:orgName/:repoName/head?shape=... or GET /api/repos/:orgName/:repoName/query?shape=... |
| Create, revise, or retract shapes | SDK commit APIs, wh commit submit, or warmhub_commit_submit |
| Manage shapes with higher-level helpers | SDK shape APIs or wh shape |
Shape writes are repository data writes. They flow through the same operation pipeline as thing and assertion writes, so they share the same validation, history, and per-operation result contract across CLI, SDK, and MCP. See Atomicity for the full contract.
Hit a problem or have a question? Get in touch.