Dags

Get DAG structure

Required API-key scope: dags:read. Returns the full topology — vertices and the tool each invokes, the edges between them, entry groups, build-time default values, and declared output variants. A DAG whose finalized_at is null may still be missing elements.

get /dags/{dag_object_id}/structure

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Path Parameters

dag_object_id string required

DAG object id

200application/json

DAG structure

default_values object[] required
port string required
value any required

Self-describing NexusData, the same shape as ports_data on walks: {"one": value} or {"many": [value, ...]}.

vertex string required
edges object[] required
from object required
port string required
variant string required
vertex string required
kind string required

normal, for_each, collect, do_while, break, or static.

to object required
port string required
vertex string required
entry_groups object[] required

Input ports a caller supplies when invoking the DAG, grouped by the entry group that selects them.

name string required
ports object[] required
port string required
vertex string required
finalized_at string | null

Null while the DAG is still being built. A non-finalized DAG may be missing elements that have not been added yet.

object_id string required
output_variants object[] required
port string required
variant string required
vertex string required
vertices object[] required
kind string required

on_chain or off_chain.

name string required
tool_fqn string required

404

DAG was not found

500

Internal server error