GetAssetLineage
Read an asset's lineage as a graph, across every source tool (not only Midjourney): its ancestors and descendants as nodes and edges. Returns {schema_version, asset_h, scope, nodes[], edges[], annotations[], truncated}. Each node has source_tool and tools[] (tool, role, attribution_source) and branch_decision (null = none recorded). Each edge has parent, child, relationship_type, derivation_kind and: state (visible by default; with include_hidden also disputed = sources disagree, not_live = no active assertion), assertion_sources (who currently affirms the edge: extracted = read from the file, user_asserted = a person, client_asserted = an integration or client), match_method (how the parent was identified, e.g. content_hash, mj_job_id, c2pa_ingredient, filename, declared), disagreement and legacy_unasserted. With include_hidden each edge also lists every source's position. annotations are non-lineage links (ReferenceFor, ComponentOf, AlternativeTo) one hop from a returned node; they are never walked. scope "lineage" (default) = ancestors up and descendants down; "family" = the whole connected component, so siblings such as Midjourney grid images appear. truncated is true when max_depth or max_nodes cut the walk short. An unknown, other-tenant or hidden asset returns the empty graph. GetMidjourneyEvolutionChain remains for Midjourney parameter diffs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"asset_h": "<asset_h>"
},
"name": "GetAssetLineage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | "lineage" = ancestors and descendants (default); "family" = the whole connected lineage component | lineage |
| asset_h | Yes | The Asset Hash (SHA-1) of the focal asset | |
| max_depth | No | Maximum hops to walk (default 10, max 50) | |
| max_nodes | No | Maximum nodes to return (default 500, max 2000) | |
| include_hidden | No | Also return disputed and not_live edges with every source position (evidence view). Default false: only visible edges. |