FamilyResponse

GET /v1/artifacts/families/{family}: the family and its versions by ordinal.

Type object

Shape

Field	Type	Description
familyrequired	ArtifactFamily	One artifact family. Workspace-scoped (D11), titled by a person or by the run that made it, and retired rather than deleted: `retired_at_ms` is a mark a reader can see and compare, and every version under a retired family stays readable (PRINCIPLES, retire state).
versionsrequired	array of ArtifactVersion

Example

{
  "family": {
    "id": "00000000-0000-4000-8000-000000000000",
    "workspace": "00000000-0000-4000-8000-000000000000",
    "title": "string",
    "created_by_run": "00000000-0000-4000-8000-000000000000",
    "created_at_ms": 0,
    "retired_at_ms": 0
  },
  "versions": [
    {
      "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
    }
  ]
}

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/families/{family}
A family with its versions

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