---
title: "Move a folder to another team"
description: "Moves the folder and everything below it into team's Files & pages (parent_id: optionally a folder of that team)."
canonical_url: https://docs.markdrop.in/api/teams/move-a-folder-to-another-team
last_updated: 2026-11-20
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Move a folder to another team

`POST https://api.markdrop.in/api/v1/workspaces/{workspace_id}/folders/{folder_id}/move-to-team`

Moves the folder and everything below it into `team`'s Files & pages (`parent_id`: optionally a folder of that team). Workspace admins, or a lead of the folder's team who is also in the target team. Private items stay private, people shares and public links keep working, and the folder's access settings move with it. A big folder finishes in the background: `job` has the progress.

- **Authentication:** API token required: `Authorization: Bearer mdk_…`.
- **Rate limit:** 20 per minute per IP address.
- **MCP tool:** `move_folder_to_team` ([tools](https://docs.markdrop.in/ai/tools))

## Path parameters

- `workspace_id` (string, required): The workspace's id, from the address of its settings page (`markdrop.in/settings/workspaces/<workspace-id>`) or from [List workspaces](https://docs.markdrop.in/api/workspaces/list-workspaces).
- `folder_id` (string, required): The folder's id, from [List folders](https://docs.markdrop.in/api/folders/list-folders).

## Request body

`application/json`, required.

- `team` (string, required): The target team (id or slug). 1–80 characters.
- `parent_id` (string): Optional: a folder of the target team to put it in. Default: where it is when its parent is in that team, else the top. Up to 40 characters.

## Responses

- `200`: OK.
- `401`: No token, or the token is revoked or mistyped.
- `422`: The request didn't validate. `detail` lists each problem, with where it is (`loc`) and why (`msg`).
- `429`: Too many requests from your IP address. Wait the seconds in `Retry-After`.

## Examples

**curl**

```bash
curl -X POST https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/folders/FOLDER_ID/move-to-team \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"team":"TEAM"}'
```

**JavaScript**

```javascript
const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/folders/FOLDER_ID/move-to-team", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "team": "TEAM"
  }),
});
const data = await res.json();
```

**Python**

```python
import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/folders/FOLDER_ID/move-to-team",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"team": "TEAM"},
)
r.raise_for_status()
print(r.json())
```
