---
title: "更新任务池全局开关"
method: PUT
path: "/admin/tasks/pool-status"
tags: ["管理员管理"]
---

# 更新任务池全局开关

`PUT /admin/tasks/pool-status`

超级管理员开启/关闭任务池新任务入口，关闭后不会再新增 pending 任务，但已有任务继续执行

## Request body

- AdminTaskPoolControlRequest
  - `enabled` boolean
  - `message` string

## Response `200`

更新成功

- object
  - `code` integer
  - `data` AdminTaskPoolStatusResponse
    - `acceptingNewTasks` boolean
    - `activeTasks` integer
    - `canRestartController` boolean
    - `configurationPendingTasks` integer
    - `configurationRunningTasks` integer
    - `drainComplete` boolean
    - `enabled` boolean
    - `message` string
    - `pendingTasks` integer
    - `runningTasks` integer
    - `state` string
    - `updatedAt` string
  - `message` string
  - `msg` string

## Other responses

- `400` — 参数错误
- `401` — 权限不足
- `500` — 更新失败

## Changes

- **2026-06-11** `87258109e9b5` — 1 info
  - endpoint added
- **2025-10-22** `dcdf027169a3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api/changes/admin/tasks/pool-status/put.md)

---

[API](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api.md) · [All operations](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oneclickvirt/oneclickvirt-api/revisions/2d2db1776645/schema)