coord

Submit Build Diff

Store an already-computed diff for one file of a build bundle against a base commit (protocol v0.2 item 6, POST /coord/builds/:build_ref/diff — the parser has no GET for this path; a deployed function ships no git object database, so tascan-agent/deployer.js computes the diff text with its own persistent worktree and this route only validates + stores it via coord_set_artifact_diff). build_sha256 must equal the artifact's own stored sha256 or the call is refused; storing a diff replaces that file's stored full content with the diff going forward. There is currently no REST route that reads a stored diff back (GET /builds/:build_ref and /builds/:build_ref/file do not surface it) — this tool only writes one. Requires agent:dispatch.

post/coord/builds/{ref}/diff

Request

  • Base URL: https://app.tascan.io/api/v1
  • URL: https://app.tascan.io/api/v1/coord/builds/{ref}/diff
  • Auth: HTTP bearer

Path parameters

refstring required

Request body

build_refstring required

sha256:<64 hex> (or the bare 64 hex) of the build the diff is about.

pathstring required

Repo-relative path from the build manifest (tascan_get_build).

base_refstring required

The commit-ish the diff was computed against (1-200 chars).

textstring required

The already-computed diff text (up to 262144 characters). This tool never computes a diff itself.

build_sha256string required

64-hex sha256 of the file at build_ref/path — must match the stored artifact's own sha256.

base_sha256string

Optional 64-hex sha256 of the file at base_ref.

truncatedboolean

True if text is itself a truncated diff.

Response

Success. JSON body: { data: ... } or an error object { error, message }.

Changes

No recorded changes to this operation across all 1 revision of this API.