---
title: "Terminate or cancel a DAG-run"
method: POST
path: "/dag-runs/{name}/{dagRunId}/stop"
tags: ["dag-runs"]
---

# Terminate or cancel a DAG-run

`POST /dag-runs/{name}/{dagRunId}/stop`

Forcefully stops a running DAG-run, or cancels a failed root DAG-run that is still pending DAG-level automatic retry.

## 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

## Response `200`

A successful response

## Other responses

- `default` — Generic error response

---

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