---
title: Digital Twins
slug: api-docs/digital-twins
description: Digital Twins endpoints for Litmus Edge: asset hierarchy, tag mapping, instance lifecycle, and template management. Reference with live execution on api.litmus.io.
docTags: 
createdAt: 2026-05-11T22:08:42.317Z
---

# Digital Twins (LE)

42 endpoints in 4.0.x. GraphQL on `/digitaltwins/v2`. Model hierarchical asset / data trees ("twins") that mirror physical equipment and roll up tag data.

:::BlockQuote
**Run these endpoints:** open the [Digital Twins folder on api.litmus.io](https://api.litmus.io/view/2s9Y5R1RvG#731012ed-3420-488c-8118-008c360625ea).
:::

## Capabilities

- Define a **Model** (the schema / hierarchy template)
- Instantiate a Model as a **Root Node**, then add **Child Nodes** under it
- Bind nodes to DeviceHub tags
- Query the tree (list, search, get-by-path)
- Import / export models as JSON

## Typical operations

| Operation                    | Purpose                          |
| ---------------------------- | -------------------------------- |
| `ListModels`                 | All models defined on the edge   |
| `CreateModel`                | Define a new model schema        |
| `UpdateModel`, `DeleteModel` | Edit / remove                    |
| `ImportModel`, `ExportModel` | JSON round-trip                  |
| `CreateRootNode`             | Instantiate a model              |
| `CreateNode`                 | Add a child node                 |
| `GetNode`, `GetNodeByPath`   | Read                             |
| `UpdateNode`, `DeleteNode`   | Mutate                           |
| `BindTagToNode`              | Attach a DeviceHub tag to a node |

:::BlockQuote
For the LEM counterpart (push twins to many edges), see [LEM Digital Twins / Asset Management](#).
:::