---
title: "Toggle scheduled task"
method: PUT
path: "/api/optimize/scheduled-task/{id}/toggle"
tags: ["Optimization"]
---

# Toggle scheduled task

`PUT /api/optimize/scheduled-task/{id}/toggle`

Enable or disable a scheduled task

## Path parameters

- `id` integer, required

## Request body

- ToggleTaskRequest
  - `enabled` boolean, required — Whether to enable or disable the task

## Response `200`

Scheduled task toggled successfully

- ToggleTaskResponse
  - `success` boolean, required
  - `message` string, required
  - `enabled` boolean, required — Current enabled status of the task

## Other responses

- `400` — Invalid task ID
- `404` — Scheduled task not found
- `500` — Internal server error

## Changes

- **2025-07-11** `d6bb02f2e15f` — 1 info
  - endpoint added
- **2025-04-25** `36671e29b758` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nimtable/apis/nimtable-api/changes/api/optimize/scheduled-task/:id/toggle/put.md)

---

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