---
title: "Changes the project of the task with the specified id."
method: POST
path: "/projects/{projectId}/projecttasks/{taskId}/changeproject"
tags: ["projectTasks"]
---

# Changes the project of the task with the specified id.

`POST /projects/{projectId}/projecttasks/{taskId}/changeproject`

Changes the project of the task with the specified id.
            This call also moves all subtasks of the task to the new project.
            This also changes the tracked time sum of the new project and the previous project.
            The related time entries of this task will also be moved to the new project.
            <Check title="Required Permissions" icon="key">The user must have `project-planning-data:write` permissions on both projects.</Check>

## Path parameters

- `projectId` string, uuid, required
- `taskId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- ChangeProjectForm
  - `projectId` string, uuid — The id of the project the task is assigned to.
  - `taskStatusId` string, uuid, nullable — Deprecated: use TaskStatusMapping instead. The id of the new status the task is assigned to.
  - `taskStatusMapping` TaskStatusMappingForm[], nullable — The task status mapping from old task status to new task status.
    - `oldStatusId` string, uuid, required — The old task status id.
    - `newStatusId` string, uuid, required — The new task status id.

## Response `204`

No Content

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)