---
title: "Move File Folder Endpoint"
method: POST
path: "/api/v1/file-folders/{folder_id}/move"
tags: ["file-folders"]
---

# Move File Folder Endpoint

`POST /api/v1/file-folders/{folder_id}/move`

Re-parent a folder. ``target_parent_id=None`` moves to the root.

Auto-renames on sibling collision (``foo → foo (1)``); raises 409 on
cycle / depth-cap / merge-leaf invariant violations.

## Path parameters

- `folder_id` string, uuid, required

## Request body

- FileFolderMove — POST /file-folders/{id}/move payload.
  - `target_parent_id` string, uuid, nullable

## Response `200`

Successful Response

- FileFolderRead
  - `id` string, required
  - `name` string, required
  - `parent_folder_id` string, nullable
  - `merge_enabled` boolean, required
  - `schema_mode` string, required
  - `merge_database_id` string, nullable, required
  - `write_semantics` string
  - `coverage_columns` string[], nullable
  - `coverage_granularity` string
  - `batch_key_pattern` string, nullable
  - `batch_size` integer, nullable
  - `batch_timeout_hours` number, nullable
  - `sealed_batch_key` string, nullable
  - `member_count` integer
  - `has_children` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/versions/a59877bf911b/schema)