---
title: "Control a set of Project-level tasks by their IDs (e.g., cancel, request stop, run now)"
method: POST
path: "/management/v1/project/task/control"
tags: ["tasks"]
---

# Control a set of Project-level tasks by their IDs (e.g., cancel, request stop, run now)

`POST /management/v1/project/task/control`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/management/v1/project/task/control`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/docs/management/v1/project/task/control/post.ts> (a function with typed inputs; its response is checked against the schema)

Accepts at most 100 task IDs in one request.

## Headers

- `x-project-id` string, nullable

## Request body

- ControlTasksRequest
  - `action` union, required
    - object: Stop the task gracefully. The task will be retried.
      - `action-type` 'stop', required
    - object: Cancel the task permanently. The task is not retried.
      - `action-type` 'cancel', required
    - object: Run the task immediately, moving the `scheduled_for` time to now. Affects only tasks in `Scheduled` or `Stopping` state.
      - `action-type` 'run-now', required
    - object: Run the task at the specified time, moving the `scheduled_for` time to the provided timestamp. Affects only tasks in `Scheduled` or `Stopping` state. Timestamps must be in RFC 3339 format.
      - `action-type` 'run-at', required
      - `scheduled-for` string, date-time, required: The time to run the task at
  - `task-ids` string[], required: Tasks to apply the action to

## Response `204`

All requested actions were successful

## Other responses

- `4XX`

---

[API](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api.md) - [All operations](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/revisions/c5cb9a12a98c?raw)