Artifacts

Immutable bytes named by their own sha256: digest and deduplicated within an organization. cow push checks each built artifact with HEAD and uploads only what is missing, so a rebuild that changed one journey uploads one bundle. The body of a PUT must hash to the digest it is filed under, and these routes carry their own size limit rather than the global request one.

HEAD /v1/artifacts/{digest}

Does this organization already have this artifact?

Auth: Clerk session token, or an org deploy key.

Errors follow the shared envelope and code table.

PUT /v1/artifacts/{digest}

Upload an artifact by its digest

Auth: Clerk session token, or an org deploy key.

Query parameters

{
  "kind": "bundle"
}

Field	Type	Required	Constraints
kind	“bundle” | “source”	yes

Errors follow the shared envelope and code table.