VerifyResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/trymnemo-com/json-schema/trymnemo-com-verify-response-schema.json",
  "title": "VerifyResponse",
  "x-generated": "2026-11-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trymnemo-com-openapi.json#/components/schemas/VerifyResponse",
  "type": "object",
  "required": [
    "verified",
    "confidence",
    "vector_uid",
    "policy_ok"
  ],
  "properties": {
    "verified": {
      "type": "boolean",
      "description": "The verdict. true: the vector resolved to an object registered to the caller's namespace or account (`vector_uid`). false: attribution to one of the caller's registered objects could not be shown; a safe outcome, not an error, and not proof that the vector belongs to someone else. true or false are both healthy results and both cost one verification. A healthy negative is `verified: false` with `vector_uid: null`, `policy_ok: false` and `lineage: null`; it is not an error. A verification that could not complete is never a 200: it is `503 verification_unavailable` and costs nothing."
    },
    "confidence": {
      "type": "number",
      "description": "Diagnostic score accompanying the verdict. Not a probability and not a threshold to apply yourself: decide on `verified`."
    },
    "vector_uid": {
      "type": [
        "string",
        "null"
      ],
      "description": "When `verified` is true: the `vector_uid` of the caller's registered object the vector resolved to. null when `verified` is false."
    },
    "policy_ok": {
      "type": "boolean",
      "description": "A policy signal separate from the verdict: always false when `verified` is false. Decide on `verified`."
    },
    "signals": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": true,
      "description": "Diagnostic metadata about how the result was reached. Informational; fields may change."
    },
    "lineage": {
      "oneOf": [
        {
          "$ref": "#/$defs/VerifyLineage"
        },
        {
          "type": "null"
        }
      ],
      "description": "Only for a verified object: where it sits in its derivation chain, as recorded at embed time. Read from the object's record, not re-verified; use getLineage for the verified chain. null means unknown (not verified, lineage not enabled, or the record could not be read), never \"root\"."
    }
  },
  "$defs": {
    "VerifyLineage": {
      "type": "object",
      "required": [
        "has_parent",
        "depth"
      ],
      "properties": {
        "has_parent": {
          "type": "boolean",
          "description": "true when the object was embedded with a verified parent."
        },
        "parent_uid": {
          "type": [
            "string",
            "null"
          ],
          "description": "The parent's `vector_uid`; null for a root."
        },
        "depth": {
          "type": "integer",
          "description": "Depth in the chain: 0 for a root, otherwise the parent's depth + 1."
        }
      }
    }
  }
}