Get Complete State At Commit

Get complete state for a node at a specific commit for canvas rendering. This endpoint reconstructs the exact state as it was at the specified commit, similar to 'git checkout <commit>'. It's useful for viewing historical states or comparing how the node looked at different points in time.

GET /orgs/{org_id}/nodes/{node_id}/tree/{branch}/commits/{commit_id}/complete

Get Complete State At Commit

cURL

curl --request GET \
  --url https://api.yertle.com/orgs/{org_id}/nodes/{node_id}/tree/{branch}/commits/{commit_id}/complete

200

{
  "node": {},
  "tags": {},
  "directories": [
    "<string>"
  ],
  "documentation": [
    "<unknown>"
  ],
  "child_nodes": [
    {}
  ],
  "visual_properties": [
    {}
  ],
  "connections": [
    {}
  ],
  "parent_nodes": [
    {}
  ],
  "ingress_connections": [
    {}
  ],
  "egress_connections": [
    {}
  ],
  "metadata": {}
}

Headers

authorization · string | null

Path Parameters

org_id · string<uuid> · required

node_id · string · required

branch · string · required

commit_id · string · required

Response

200

application/json

Successful Response

Full state for a node (rendered canvas view).

The response contains the node's metadata plus all visual + relational data needed by the frontend to render the canvas: child nodes, visual properties, connections, parents, and branch context. Nested shapes are intentionally loose because the visual schema is evolving.

node · Node · object · required

Node metadata (id, title, description, org_id, timestamps)

tags · Tags · object

Node tags

directories · string[]

Directory paths the node belongs to

documentation · any[]

Attached documentation entries

child_nodes · Child Nodes · object[]

Child node summaries

visual_properties · Visual Properties · object[]

Visual properties for child nodes

connections · Connections · object[]

Connections between child nodes

parent_nodes · Parent Nodes · object[]

Parent nodes that contain this node

ingress_connections · Ingress Connections · object[]

Incoming connections from sibling contexts

egress_connections · Egress Connections · object[]

Outgoing connections to sibling contexts

metadata · Metadata · object

Aggregate counts (child/connection totals)