---
title: "Pause or resume the scheduler"
method: POST
path: "/services/scheduler/pause"
tags: ["system"]
---

# Pause or resume the scheduler

`POST /services/scheduler/pause`

Pauses or resumes scheduler-driven run creation for every DAG at once. Admin only.

Pausing has the same effect as suspending every DAG by hand. Manual, webhook, and sub-DAG runs keep working. Queued scheduler-managed runs are aborted and dequeued, catch-up windows are discarded rather than deferred, and nothing replays on resume. One-off schedules stay pending and fire late once the scheduler resumes.

## Query parameters

- `remoteNode` string

## Request body

- object
  - `paused` boolean, required — Pause state to set for the scheduler
  - `reason` string — Operator-facing explanation shown while paused

## Response `200`

A successful response

## Other responses

- `default` — Generic error response

## Changes

- **2026-09-13** (v1) `168a290ede5a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/dagucloud/apis/dagu/changes/services/scheduler/pause/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/f2d1c9884f74?raw)