---
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
  - `filePath` string — Absolute file path of the DAG file on disk
  - `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

- **2026-07-26** (v1) `f6dcf7250db7` — 6 info
  - added the optional property `dag/tasks` to the response with the `200` status
  - added the optional property `dag/type` to the response with the `200` status
  - added the optional property `latestDAGRun/allOf[subschema #2]/controllerEvents` to the response with the `200` status
  - added the optional property `latestDAGRun/allOf[subschema #2]/controllerTasks` to the response with the `200` status
  - …2 more
- **2026-07-26** (v1) `973f666d7b5a` — 2 info
  - added the optional property `latestDAGRun/allOf[subschema #2]/onInit` to the response with the `200` status
  - added the optional property `latestDAGRun/allOf[subschema #2]/onWait` to the response with the `200` status
- **2026-07-25** (v1) `9adffc836041` — 1 info
  - added the optional property `latestDAGRun/allOf[#/components/schemas/DAGRunSummary]/triggerActor` to the response with the `200` status
- **2026-07-23** (v1) `75b8e91aaf57` — 3 warning, 41 info
  - added the new `conflict` enum value to the `code` response property for the response status `default`
  - added the new `human_task_resume_failed` enum value to the `code` response property for the response status `default`
  - added the new `payload_too_large` enum value to the `code` response property for the response status `default`
  - added the optional property `dag/handlerOn/abort/humanTask` to the response with the `200` status
  - …40 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/f6dcf7250db7/schema)