---
title: "Preview edited DAG-run retry"
method: POST
path: "/dag-runs/{name}/{dagRunId}/edit-retry/preview"
tags: ["dag-runs"]
---

# Preview edited DAG-run retry

`POST /dag-runs/{name}/{dagRunId}/edit-retry/preview`

Validates an edited DAG definition against a previous DAG-run and returns the default step skip selection.

## Path parameters

- `name` string, regex, required — Name of the DAG
- `dagRunId` string, required — Unique identifier for the DAG-run. The special value 'latest' can be used to reference the most recent DAG-run.

## Query parameters

- `remoteNode` string

## Request body

- object
  - `spec` string, required — Edited DAG specification in YAML format.
  - `dagName` string — Optional DAG name override for the edited retry run.

## Response `200`

Successfully previewed the edited retry

- object
  - `dagName` string, required — Resolved DAG name for the edited retry.
  - `skippedSteps` string[], required — Default steps selected to be skipped.
  - `runnableSteps` string[], required — Steps that will be started if not skipped.
  - `steps` Step[], required — Resolved edited DAG steps in execution order for preview rendering. — unresolved $ref
  - `ineligibleSteps` object[], required — Previous completed steps that cannot be skipped with the edited specification.
    - `stepName` string, required
    - `reason` string, required
  - `errors` string[], required — Validation errors that must be fixed before launching.
  - `warnings` string[], required — Non-blocking warnings for the edited retry.

## Other responses

- `default` — Generic error response

## Changes

- **2026-08-07** (v1) `478671469a25` — 2 info
  - added the optional property `steps/items/inputs` to the response with the `200` status
  - added the optional property `steps/items/outputs/items/path` to the response with the `200` status
- **2026-07-23** (v1) `75b8e91aaf57` — 3 warning, 1 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 `steps/items/humanTask` to the response with the `200` status
- **2026-07-09** (v1) `9d0cf8f4b61c` — 2 breaking, 2 info
  - the response property `steps/items/preconditions/items/condition` became optional for the status `200`
  - the response property `steps/items/repeatPolicy/condition/condition` became optional for the status `200`
  - added the optional property `steps/items/preconditions/items/eval` to the response with the `200` status
  - added the optional property `steps/items/repeatPolicy/condition/eval` to the response with the `200` status
- **2026-06-18** (v1) `162df20bbef8` — 1 info
  - added the optional property `steps/items/outputs` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/dagucloud/apis/dagu/changes/dag-runs/:name/:dagRunId/edit-retry/preview/post.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) · [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc.dev/dagucloud/apis/dagu/revisions/93cc41f2018a?raw)