---
title: "Record Model Input Lineage"
method: POST
path: "/v1/tools/record_model_input_lineage"
tags: ["TODO_TAGS_REVIEW"]
---

# Record Model Input Lineage

`POST /v1/tools/record_model_input_lineage`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/record_model_input_lineage`
- Auth: none declared

Attests attribute-level data lineage for a model's input data, which source system, which field, what transformation was applied, feeding which model run, distinct from every existing model-risk node (art-450/451/453/488/489), none of which attest where a model's input data came from, only what the model did with declared inputs. Input attributes are SUPPLIED and asserted by the caller (zero-egress); this node never fetches or validates against a live data warehouse or source system. An attribute declared without a source_system is reported as a legitimate finding (unmapped_attribute_count), never silently dropped or treated as an error. run_ref is optional, a caller with no model-run artifact yet still gets a valid lineage receipt. ECB Guide on effective risk data aggregation and risk reporting (May 2024) §3.4(3) requires complete, up-to-date data lineages on data attribute level for the risk indicators and critical data elements within scope; this node gives that its own citable artifact. SR 26-2 (effective 2026-04-17) scopes the model-risk context to conventional quantitative models only. Feeds the model-risk-lineage-pack chain (art-562) as an optional additional citation, never a required one.

**Tool URL:** https://ainumbers.co/chaingraph/art-648-record-model-input-lineage.html

## Request body

- object
  - `as_of_date` unknown, required
  - `attributes` unknown[], required
    - unknown
  - `model_id` unknown, required
  - `run_ref` unknown, required

## Response `200`

Successful tool execution result

- object
  - `as_of_date` string
  - `attribute_count` integer
  - `attributes` object[]
    - `field_name` string
    - `sensitivity_tier` string
    - `source_field` string
    - `source_system` string
    - `transformation_applied` string
  - `fence` string
  - `model_id` string
  - `not_proven` object[]
    - `detail` string
    - `item` string
  - `regulatory_framework` string
  - `run_ref` object
    - `execution_hash` string
    - `tool_id` string
  - `structural_error` string
  - `unmapped_attribute_count` integer

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)