Skip to content

Shapes

WarmHub does not currently mount REST endpoints under /api/repos/:orgName/:repoName/shapes.

Use these supported surfaces instead:

TaskSurface
Read repository data filtered by shapeGET /api/repos/:orgName/:repoName/head?shape=... or GET /api/repos/:orgName/:repoName/query?shape=...
Create, revise, or retract shapesSDK commit APIs, wh commit submit, or warmhub_commit_submit
Manage shapes with higher-level helpersSDK 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.