Move Folder

Moves the folder to a new parent folder. When the move folder operation is performed the folder along with its children will be moved to the new parent folder. The folder can only be moved to an active parent folder. The path of the folder and its children will be updated accordingly.The move operation is an asynchronous operation and the response will contain the job identifier. The status of the job can be checked using the job status API. The move operation can only be performed when there is no outstanding job for the source identifier. Major version will be incremented whenever a move operation is performed on the folder.

Prerequisites

• Source and target folder should be created. To know more about creating a folder refer here

Request

POST {baseUrl}/spaces/{spaceId}/folders/{folderId}/move

• HEADER:

  • Authorization: Bearer {tid token}

• Body:

  • targetParentId - The target parent identifier where the folder needs to be moved

Example request body:

{
    "targetParentId":"b93c5919-e3e8-47f9-bf26-d99c8864a19f"
}

Response

Example Response:

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "RUNNING",
  "type": "MOVE",
  "createdAt": "2024-06-25T06:37:31Z",
  "createdByTrn": "trn:tid:application:f85bc802-5481-4581-b972-c4652d595ec7",
  "message": "Move job is in progress"
}

To know more about move folder API refer here