---
title: "Move or rename resource(s) (files or directories)"
method: PUT
path: "/resources/move"
tags: ["Resources"]
---

# Move or rename resource(s) (files or directories)

`PUT /resources/move`

## Request body

- ModelsMoveResourceRequest
  - `destination` string — Destination is the exact target path (single source) or base directory (multiple sources). Empty string means the root directory.
  - `force` boolean — Force overwrites existing resources at the target paths when true.
  - `source` string — Source is kept for backward compatibility (single source). Combined with Sources when both are provided; duplicates are removed.
  - `sources` string[] — Sources is a list of virtual resource paths to move. Combined with Source when both are provided; duplicates are removed.

## Response `200`

OK

- object
  - `data` object
    - `items` ModelsResourceEntry[]
      - `created_at` string
      - `id` integer
      - `is_dir` boolean
      - `name` string
      - `path` string
      - `size` integer
      - `updated_at` string
      - `user_id` integer
    - `total` integer
  - `status` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

## Changes

> 21 revisions in range; 1 could not be searched.

- **2026-04-28** `d78a110a89ae` — 1 info
  - endpoint added
- **2026-03-26** `fe95938acc20` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/changes/resources/move/put.md)

---

[API](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api.md) · [All operations](https://skmtc.dev/vxcontrol/apis/pentagi-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vxcontrol/pentagi-swagger-api/revisions/7c1cbf7abaa1/schema)