---
title: "Move task"
method: PUT
path: "/task/move/{id}"
tags: ["Tasks"]
---

# Move task

`PUT /task/move/{id}`

Move a task to another project, optionally into a named column. Both projects must be in the same workspace.

## Path parameters

- `id` string, required

## Request body

- object
  - `destinationProjectId` string, required
  - `destinationStatus` string — Defaults to the destination project's first column.

## Response `200`

The moved task, with both project ids

- MoveTaskResult
  - `task` Task, required
    - `id` string, required
    - `projectId` string, required
    - `position` number, nullable, required — Order within its column, ascending.
    - `number` number, nullable, required — Per-project counter shown as {projectSlug}-{number}.
    - `userId` string, nullable, required — The assignee, if any.
    - `title` string, required
    - `description` string, nullable, required
    - `status` string, required — The slug of the column the task sits in.
    - `priority` string, required — One of: no-priority, low, medium, high, urgent.
    - `startDate` string, date-time, nullable, required
    - `dueDate` string, date-time, nullable, required
    - `createdAt` string, date-time, required
  - `sourceProjectId` string, required
  - `destinationProjectId` string, required

## Other responses

- `400` — Invalid body, or unknown task
- `401` — Missing or invalid credentials
- `403` — No workspace access, or missing task:update permission
- `404` — Task or destination project not found

## Changes

- **2026-08-24** `08bbb5bedb5d` — 2 breaking, 11 info
  - the response property `task/dueDate` became nullable for the status `200`
  - the response property `task/startDate` became nullable for the status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - …9 more
- **2026-07-11** `32cece1ebe43` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/task/move/:id/put.md)

---

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