---
title: "Move User File Endpoint"
method: POST
path: "/api/v1/files/{file_id}/move"
tags: ["files"]
---

# Move User File Endpoint

`POST /api/v1/files/{file_id}/move`

Move a file into a folder (or to the root if ``target_folder_id`` is None).

Side effects when source/target folders are merge-enabled:
- source-side: drop the file's slice from the source collection (parquet
  rewrite + DatasetMember delete) so dashboards reflect the move
  immediately.
- target-side: re-arm the file's databases and dispatch a Temporal parse
  so the rows land in the target collection.

Filename collisions in the destination are auto-resolved with
``foo (1).csv`` style suffixes.

## Path parameters

- `file_id` string, uuid, required

## Request body

- UserFileMove — POST /files/{id}/move payload — destination folder (None = root).
  - `target_folder_id` string, uuid, nullable

## Response `200`

Successful Response

- UserFileRead
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `user_id` string, uuid, required
  - `folder_id` string, uuid, nullable
  - `name` string, required
  - `file_type` string, required
  - `size_bytes` integer, required
  - `meta` object, required
  - `created_at` string, date-time, required
  - `parse_state` string, required

## 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)