/api/repos/{repo_name}/diff-commit endpoint and is designed for workflows
that already have git diff --binary output available.
createCommitFromDiff shares the same branch metadata (expectedHeadSha, baseBranch,
ephemeral, ephemeralBase) as createCommit. Instead of calling .addFile(), pass the patch
contents through the diff field. The SDK accepts strings, Uint8Array, ArrayBuffer, Blob/File
objects, or any iterable/async iterable of byte chunks and handles chunking + base64 encoding. In
Go, the Diff field accepts an io.Reader.
The gateway applies the patch with git apply --cached --binary, so make sure your diff is
compatible with that command. It must include file headers (diff --git), mode lines, and hunk
headers. Empty patches and patches that do not apply cleanly result in a RefUpdateError with the
mapped status ( conflict, precondition_failed, etc.) and partial ref update information.
Options
Ordered ref policy rules (
{ pattern, ops? }) in the JWT for this call. Code Storage uses the first rule that matches the target ref. Python: ref_policies. Go: RefPolicies with type storage.RefPolicyList. See Ref Policies.