---
title: "Move a folder"
method: PATCH
path: "/api/v2/folders/{id}/move"
tags: ["Folders"]
---

# Move a folder

`PATCH /api/v2/folders/{id}/move`

Moves a folder — and all of its task lists and tasks — to a different project. Provide the target `project_id`.

When the target project uses a **different workflow** than the source, a `map` of workflow status IDs is required: keys are the source workflow's status IDs, values are the target workflow's status IDs. The map must cover **every** status in the source workflow.

Tasks are reassigned to the target project and their statuses remapped accordingly. Assignees and subscribers who are not members of the target project are removed from the moved tasks.

```json
{
  "data": {
    "type": "folders",
    "attributes": {
      "project_id": 31055,
      "map": { "101": 205, "102": 206, "103": 207 }
    }
  }
}
```

## Path parameters

- `id` string, required

## Headers

- `X-Organization-Id` string, required

## Response `200`

A single folder resource response.

## Other responses

- `422` — The folder could not be moved due to validation errors.

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/versions/6bb0150a5c5f/schema)