Sign in
Assets

Get asset lineage

Get the derivation lineage of an asset by asset ID: the inputs it was generated from, the generation requests along the way, and any referenced smart entities, traversed recursively up to depth levels. Deleted or expired ancestors stay in the graph flagged as tombstones; inputs that were never captured appear as external inputs.

get/assets/{asset_id}/lineage

Path parameters

asset_idstring required

Asset ID

Example:d8b6elcregj72v34jr8g

Asset ID

Query parameters

depthinteger

Maximum traversal depth (levels of derivation edges)

Example:5

Maximum traversal depth (levels of derivation edges)

Response

Asset lineage graph

Example response

{
  "lineage": {
    "focus": "asset:0f343b0931126a20f133d67c2b018a3b",
    "nodes": [
      {
        "id": "asset:0f343b0931126a20f133d67c2b018a3b",
        "output_key": "0f343b0931126a20f133d67c2b018a3b",
        "url": "https://v3b.fal.media/files/b/0a9b4900/portrait.png",
        "request_id": "019e6d0a-e5be-7b82-b329-35ae64296902",
        "asset_id": "d8b6elcregj72v34jr8g"
      }
    ],
    "edges": [
      {
        "from": "external:9e107d9d372bb6826bd81d3542a419d6",
        "to": "request:019e6d0a-e5be-7b82-b329-35ae64296902",
        "entities": [
          {
            "entity_id": "43ce3411-1a25-4d14-875e-3562d341b090",
            "entity_type": "character",
            "name": "Alice",
            "handle": "alice"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this endpoint across all 2 revisions of this API.