Sustema

ENTITY developer reference

AssessmentLineageProjection

Candidate documentation for reading and synthetic examples. Account creation, live API access, SDKs, collections and MCP are not available here. A released service profile and matching integration instructions are required before use.

This is a documentation reading view of an unreleased candidate, not a downloadable replacement schema. Public wire names, types and constraints are retained except for the explicitly marked private-only subsets and route patterns. Private governance references are explained in public language. Use only a separately released, verified generation for clients. Read the explicit exclusions.

This is the public candidate schema reading view. Read it with the operation that uses it; a representable field does not establish enabled coverage or entitlement.

Immutable history and customer ownership remain distinct from shared publication. A replay retains assessment/receipt IDs and original clocks. A new qualifying refresh has a new assessment and receipt even for unchanged code; remedies retain the original delivery lineage. Projection-only variant: referenced prior IDs are null unless independently related, retained and allowed now, even for refresh. Financial binding and original receipt are null for result_only or after original joins expire. This never weakens the original creation/grant AssessmentLineage.

Declared type: "object"

Declared fields

This list shows only properties declared directly in this schema. Required labels refer only to this schema’s own required array. Referenced, composed and conditional rules can add constraints; a field not listed as required here is not guaranteed to be optional.

assessment_id

Listed in this schema’s required array.

Declared type
"string"
Declared format
"uuid"
Reading definition for assessment_id
{
  "type": "string",
  "format": "uuid",
  "x-profile-maxLength": "string_characters_max"
}

purpose

Listed in this schema’s required array.

Declared type
"string"
Reading definition for purpose
{
  "type": "string",
  "enum": [
    "acquisition",
    "refresh"
  ],
  "x-profile-maxLength": "string_characters_max"
}

prior_acquisition_id

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for prior_acquisition_id
{
  "anyOf": [
    {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    {
      "type": "null"
    }
  ]
}

prior_assessment_id

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for prior_assessment_id
{
  "anyOf": [
    {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    {
      "type": "null"
    }
  ]
}

outcome

Listed in this schema’s required array.

Declared type
"string"
Reading definition for outcome
{
  "type": "string",
  "enum": [
    "initial",
    "changed",
    "unchanged"
  ],
  "x-profile-maxLength": "string_characters_max"
}

clocks

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for clocks
{
  "$ref": "#/components/schemas/AssessmentClocksProjection"
}

offer_binding

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for offer_binding
{
  "anyOf": [
    {
      "$ref": "#/components/schemas/OfferBinding"
    },
    {
      "type": "null"
    }
  ]
}

original_receipt_id

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for original_receipt_id
{
  "anyOf": [
    {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    {
      "type": "null"
    }
  ]
}

Schema reading view

Read all retained constraints, including any allOf, oneOf, anyOf, conditional and additional-property constraints. The field list does not combine branches. Explicitly marked private-only omissions mean this view is not an executable substitute for the original schema or a released contract.

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "assessment_id": {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    "purpose": {
      "type": "string",
      "enum": [
        "acquisition",
        "refresh"
      ],
      "x-profile-maxLength": "string_characters_max"
    },
    "prior_acquisition_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "x-profile-maxLength": "string_characters_max"
        },
        {
          "type": "null"
        }
      ]
    },
    "prior_assessment_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "x-profile-maxLength": "string_characters_max"
        },
        {
          "type": "null"
        }
      ]
    },
    "outcome": {
      "type": "string",
      "enum": [
        "initial",
        "changed",
        "unchanged"
      ],
      "x-profile-maxLength": "string_characters_max"
    },
    "clocks": {
      "$ref": "#/components/schemas/AssessmentClocksProjection"
    },
    "offer_binding": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/OfferBinding"
        },
        {
          "type": "null"
        }
      ]
    },
    "original_receipt_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "x-profile-maxLength": "string_characters_max"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "assessment_id",
    "purpose",
    "prior_acquisition_id",
    "prior_assessment_id",
    "outcome",
    "clocks",
    "offer_binding",
    "original_receipt_id"
  ],
  "description": "Immutable history and customer ownership remain distinct from shared publication. A replay retains assessment/receipt IDs and original clocks. A new qualifying refresh has a new assessment and receipt even for unchanged code; remedies retain the original delivery lineage. Projection-only variant: referenced prior IDs are null unless independently related, retained and allowed now, even for refresh. Financial binding and original receipt are null for result_only or after original joins expire. This never weakens the original creation/grant AssessmentLineage.",
  "allOf": [
    {
      "if": {
        "properties": {
          "purpose": {
            "const": "refresh"
          }
        },
        "required": [
          "purpose"
        ]
      },
      "then": {
        "properties": {
          "outcome": {
            "type": "string",
            "enum": [
              "changed",
              "unchanged"
            ],
            "x-profile-maxLength": "string_characters_max"
          }
        }
      },
      "else": {
        "properties": {
          "outcome": {
            "const": "initial"
          }
        }
      }
    }
  ]
}

Related schemas

All API operations