Are any way to stop a running workflow？

[shesung]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
• [FOR CHINESE USERS] 请务必使用英文提交 Issue，否则会被关闭。谢谢！:)
• Please do not modify this template :) and fill in all the required fields.

Content

How can I cancel a running workflow without stopping the service？

[dosubot[bot]]

Yes, you can stop a running workflow in Dify without stopping the entire service by using the API endpoint:
POST /v1/workflows/tasks/{taskId}/stop
Replace {taskId} with the ID of the workflow task you want to stop. This will signal the backend to halt the specific workflow task, and you'll get a response like {"result": "success"} if the stop request is accepted. This works at the task level and does not affect other workflows or the service as a whole citation.

If you're using an older version (like v1.9.2), there was a bug where stopped workflows could show as "failed" instead of "stopped" due to a race condition, but this has been fixed in newer releases citation. If you run into stuck statuses, you can manually update the workflow status in the database or use admin endpoints, but upgrading is the best long-term fix.

You’ll need a valid API token and the task ID to use this endpoint. The API interface and response format have remained consistent across recent versions. For more details on the backend logic, see the implementation citation.

Let me know if you need help finding the task ID or have questions about authentication!

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}