---
title: "Move a Single File to a Folder"
slug: "moveasinglefiletoafolder"
updated: 2026-04-16T07:02:33Z
published: 2026-04-16T07:02:33Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.12dsynergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Move a Single File to a Folder

This tutorial demonstrates how to move a single file to a folder via the RESTful API.

The commands are provided in curl and can be run from the command prompt when the 12d Synergy Server is running (or in a batch script).

> [!NOTE]
> Additional API documentation
> 
> To get a list of most of the API requests available, with the 12d Synergy server running, browse [http://synergy.myserver.com/api-docs/ui/index](http://synergy.myserver.com/api-docs/ui/index).
> 
> (Replace [synergy.myserver.com](http://synergy.myserver.com) with the external server address and update the port numbers if necessary.)

### 1.1. Getting the Personal Access Token to Access API

The tutorial for getting the PAT is here: [Generate PAT in Web client](/v1/docs/webclientgenerateapersonalaccesstokenpatinwebclientdoc).

### 1.2. Moving a Single File to a Folder

This request is in the API documentation under Files, marked 'Move a file to a folder'.

Click ![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/expand.png) in the line below to see the code.

****Sample Request****

```SampleRequest
curl --location 'http://synergy.myserver.com/api/v1/files/move' \
--header 'Authorization: Bearer <your-token-here>' \
--header 'Content-Type: application/json' \
--data '{
  "copy_to_new_version": true,
  "folder_id": {
    "_id": 0,
    "_server_id": 0,
    "_server_guid": "00000000-0000-0000-0000-000000000000",
    "IDString": "string"
  },
  "new_name": "string",
  "restore_if_deleted": true,
  "id": {
    "_id": 0,
    "_server_id": 0,
    "_server_guid": "00000000-0000-0000-0000-000000000000",
    "IDString": "string"
  },
  "description": "string",
  "change_attributes": [
    {
      "attribute_id": {
        "_id": 0,
        "_server_id": 0,
        "_server_guid": "00000000-0000-0000-0000-000000000000",
        "IDString": "string"
      },
      "type": 0,
      "value": {}
    }
  ],
  "file_attributes": [
    {
      "attribute_id": {
        "_id": 0,
        "_server_id": 0,
        "_server_guid": "00000000-0000-0000-0000-000000000000",
        "IDString": "string"
      },
      "type": 0,
      "value": {}
    }
  ],
  "workflow_capture_data": [
    {}
  ]
}'
```

**Sample Response**

The response will either be true if successful or false.