RegisterVersionRequest

POST /v1/artifacts/families/{family}/versions. Metadata only: the blob is an address in the family's workspace, already uploaded through the Store's blob route, and the gateway verifies it is there before the version exists. The size is the Store's word, not the caller's.

Type object

Shape

Field	Type	Description
registration_idrequired	RegistrationId
blobrequired	BlobHash	`<algorithm>:<digest>` - `b3:<64 hex>`. The algorithm is in the value because a hash that does not say what it is cannot be migrated: adopting a second one has to be additive, or every document already written is orphaned.
mimerequired	MediaType	A `type/subtype` media type, ASCII and lowercased, as the blob store records it. Not content: it prints in full.
filename	Filename or null
produced_by	ProducedBy or null
derived_from	ArtifactVersionId or null

Example

{
  "registration_id": "00000000-0000-4000-8000-000000000000",
  "blob": "string",
  "mime": "string",
  "filename": "string",
  "produced_by": {
    "run": "00000000-0000-4000-8000-000000000000",
    "generation": 0
  },
  "derived_from": "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

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

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