RegisterVersionResponse

Type object

Shape

Field	Type	Description
versionrequired	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.
retriedrequired	boolean	This call found the version an earlier call with the same registration id had made.

Example

{
  "version": {
    "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
  },
  "retried": false
}

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

POST/v1/artifacts/families/{family}/versions
Register an immutable version of a family

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