Provenance

A version's provenance: the version, every ancestor reached by following derived_from (nearest first), and every run link on any of them.

Three generations read like a sentence: v3 was produced by run R2, which consumed v2, which was derived from v1, which run R1 produced. P1.13 draws that sentence; this is the fact it draws from.

Type object

Shape

Field	Type	Description
subjectrequired	ArtifactVersion	One immutable artifact version. Identity is `id`; content is `blob`, an address in the workspace's content-addressed store. The two are separate on purpose: the same bytes registered twice are two versions with two histories, and a reference to a version keeps meaning the same thing after the family moves on. `derived_from` names the version this one was made from, which is how a provenance walk crosses generations.
ancestorsrequired	array of ArtifactVersion	Nearest first: `subject.derived_from`, then its `derived_from`, …
runsrequired	array of RunLink	Links on the subject and on every ancestor, subject's first.
deleted_runs	array of RunId	Which of the runs named above no longer exist. A person may delete a run and keep what it produced. The result stays, and its provenance still names the run that made it - so the sentence has to say a run that was deleted rather than print an id that resolves to nothing. Recorded when the trash is emptied and read back here; a run absent from this set is simply a run, whether it belongs to this device or another one. `#[serde(default)]`, so a walk from a store that predates the set reads as none deleted rather than failing to decode.

Example

{
  "subject": {
    "id": "00000000-0000-4000-8000-000000000000",
    "family": "00000000-0000-4000-8000-000000000000",
    "ordinal": 0,
    "blob": "string",
    "size_bytes": 0,
    "mime": "string",
    "filename": "string",
    "produced_by": {
      "run": "00000000-0000-4000-8000-000000000000",
      "generation": 0
    },
    "registration_id": "00000000-0000-4000-8000-000000000000",
    "derived_from": "00000000-0000-4000-8000-000000000000",
    "created_at_ms": 0
  },
  "ancestors": [
    {
      "id": "00000000-0000-4000-8000-000000000000",
      "family": "00000000-0000-4000-8000-000000000000",
      "ordinal": 0,
      "blob": "string",
      "size_bytes": 0,
      "mime": "string",
      "filename": "string",
      "produced_by": {
        "run": "00000000-0000-4000-8000-000000000000",
        "generation": 0
      },
      "registration_id": "00000000-0000-4000-8000-000000000000",
      "derived_from": "00000000-0000-4000-8000-000000000000",
      "created_at_ms": 0
    }
  ],
  "runs": [
    {
      "run": "00000000-0000-4000-8000-000000000000",
      "version": "00000000-0000-4000-8000-000000000000",
      "role": "input",
      "linked_at_ms": 0
    }
  ],
  "deleted_runs": [
    "00000000-0000-4000-8000-000000000000"
  ]
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

GET/v1/artifacts/versions/{version}/provenance
A version's provenance

Generated from contract version 1. Last updated November 12, 2026.