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 componentId 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.