---
title: "Move Multiple Files to a Folder"
slug: "movemultiplefilestoafolder"
updated: 2026-04-16T07:03:05Z
published: 2026-04-16T07:03:05Z
---

> ## 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 Multiple Files to a Folder

This tutorial demonstrates how to move multiple files 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 the API

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

### 1.2. Moving Multiple Files to a Folder

This request is available in the API documentation under ‘Files marked 'Move multiple files to a folder'.

This is similar to [Move a single file to a folder](/v1/docs/moveasinglefiletoafolderdoc). The difference is that the request should pass an array instead of a single object.

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": [

      {}

    ]

  }

]'
```

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

****Sample Response****

```SampleResponse
{

  "Responses": [

    {

      "Result": 0,

      "Success": true,

      "Message": "string",

      "FileId": {

        "_id": 0,

        "_server_id": 0,

        "_server_guid": "00000000-0000-0000-0000-000000000000",

        "IDString": "string"

      },

      "FolderId": {

        "_id": 0,

        "_server_id": 0,

        "_server_guid": "00000000-0000-0000-0000-000000000000",

        "IDString": "string"

      },

      "NewFileName": "string",

      "ChangeData": {

        "description": "string",

        "file_attribs": {},

        "file_attribs_to_remove": [

          {

            "_id": 0,

            "_server_id": 0,

            "_server_guid": "00000000-0000-0000-0000-000000000000",

            "IDString": "string"

          }

        ],

        "file_change_attribs": {},

        "replacements": {},

        "workflow_capture_data": {

          "property_bytes": "string",

          "associations": [

            {

              "assoc_default_description": "string",

              "assoc_entity_id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              },

              "assoc_desc": "string",

              "assoc_entity_type": 0,

              "type": 0,

              "name": "string",

              "id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              },

              "transition_id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              },

              "optional": true

            }

          ],

          "form_fills": [

            {

              "capture_id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              },

              "fill_name": "string",

              "result_json": "string",

              "session_id": "string"

            }

          ]

        },

        "FileAttributeValues": [

          {

            "key": {

              "_id": 0,

              "_server_id": 0,

              "_server_guid": "00000000-0000-0000-0000-000000000000",

              "IDString": "string"

            },

            "value": {

              "_value": {},

              "enum_id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              },

              "value_id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              }

            }

          }

        ],

        "FileChangeAttributeValues": [

          {

            "key": {

              "_id": 0,

              "_server_id": 0,

              "_server_guid": "00000000-0000-0000-0000-000000000000",

              "IDString": "string"

            },

            "value": {

              "_value": {},

              "enum_id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              },

              "value_id": {

                "_id": 0,

                "_server_id": 0,

                "_server_guid": "00000000-0000-0000-0000-000000000000",

                "IDString": "string"

              }

            }

          }

        ]

      },

      "CopyToNewVersion": true,

      "RestoreIfDeleted": true

    }

  ],

  "Success": true,

  "Message": "string"

}
```