---
title: "Retrieve comprehensive DAG information"
method: GET
path: "/dags/{fileName}"
tags: ["dags"]
---

# Retrieve comprehensive DAG information

`GET /dags/{fileName}`

Fetches detailed information about a specific DAG definition

## Path parameters

- `fileName` string, regex, required — Name of the DAG file

## Query parameters

- `remoteNode` string

## Response `200`

A successful response

- object — Response object for getting details of a DAG
  - `dag` DAGDetails — unresolved $ref
  - `localDags` LocalDag[], required — List of local DAGs that are part of this DAG
    - `name` string, required — Name of the local DAG
    - `dag` DAGDetails — unresolved $ref
    - `errors` string[], required — List of errors encountered while processing the local DAG
  - `latestDAGRun` DAGRunDetails, required — unresolved $ref
  - `suspended` boolean, required — Whether the DAG is suspended
  - `errors` string[], required — List of errors encountered during the request
  - `spec` string — The DAG specification in YAML format
  - `editorHints` DAGEditorHints — Editor-only metadata used to synthesize per-document schema hints
    - `inheritedLegacyDefinitions` InheritedLegacyDefinitionHint[], required — Deprecated legacy execution definitions inherited from base config and available to the current DAG
      - `name` string, required — Deprecated legacy execution definition name
      - `targetType` string, required — Builtin executor type that the deprecated legacy execution definition expands to
      - `description` string — Optional deprecated legacy execution definition description
      - `inputSchema` object, required — Resolved JSON Schema object used to validate and document with input
      - `outputSchema` object — Resolved JSON Schema object used to validate stdout JSON output
    - `inheritedCustomActions` InheritedCustomActionHint[] — Custom actions inherited from base config and available to the current DAG
      - `name` string, required — Custom action name
      - `description` string — Optional custom action description
      - `inputSchema` object, required — Resolved JSON Schema object used to validate and document with input
      - `outputSchema` object — Resolved JSON Schema object used to validate stdout JSON output

## Other responses

- `default` — Generic error response

## Changes

> 70 revisions in range; 3 could not be searched.

- **2026-08-16** (v1) `f8982f33e540` — 7 info
  - added the optional property `latestDAGRun/allOf[subschema #2]/nodes/items/agentSession` to the response with the `200` status
  - added the optional property `latestDAGRun/allOf[subschema #2]/onAbort/agentSession` to the response with the `200` status
  - added the optional property `latestDAGRun/allOf[subschema #2]/onExit/agentSession` to the response with the `200` status
  - added the optional property `latestDAGRun/allOf[subschema #2]/onFailure/agentSession` to the response with the `200` status
  - …3 more
- **2026-08-08** (v1) `baa17af029e5` — 9 warning, 9 info
  - removed the optional property `latestDAGRun/allOf[subschema #2]/nodes/items/incremental` from the response with the `200` status
  - removed the optional property `latestDAGRun/allOf[subschema #2]/onAbort/incremental` from the response with the `200` status
  - removed the optional property `latestDAGRun/allOf[subschema #2]/onExit/incremental` from the response with the `200` status
  - removed the optional property `latestDAGRun/allOf[subschema #2]/onFailure/incremental` from the response with the `200` status
  - …14 more
- …earlier changes not shown

[Full history](https://skmtc.dev/dagucloud/apis/dagu/changes/dags/:fileName/get.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) · [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/9fcb8e054188/schema)