Writes

WarmHub does not currently mount a REST write endpoint. HTTP clients should use one of the supported write surfaces:

Surface	Method
SDK	client.commit.apply(...)
CLI	wh commit submit
MCP	warmhub_commit_submit

For operation fields and examples, see Commit Operations and the SDK AddOperation reference.

The three surfaces share one operation pipeline and return per-operation results. Domain failures are reported in operations[] with status: "error" and partial: true; request-level failures such as auth, malformed input, or infrastructure errors still return a top-level error. See Atomicity for the full contract.

Writes can be attributed to an installed component by passing componentRef (the component’s Org/Name) on the SDK or MCP call. See Component Identity for the token rules, action-token behavior, and current SDK/CLI surface coverage.

The REST HTTP API currently exposes repository read endpoints such as head, query, and about. Shape management is available through SDK, CLI, and commit-based workflows rather than REST shape endpoints.