POST/api/v1/workspaces/{workspace_id}/folders/{folder_id}/move-to-team

Move a folder to another 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.

API token required20 per minute per IPMCP: move_folder_to_team
Code samples and Try it

Path parameters

#
  • workspace_idstringRequired

    The workspace's id, from the address of its settings page (markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.

  • folder_idstringRequired

    The folder's id, from List folders.

Request body

#

application/json, required

  • teamstringRequired

    The target team (id or slug). 1–80 characters.

  • parent_idstring

    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

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