Copy Folder

Copies the folder to a new parent folder. When the copy folder operation is performed the folder along with its children will be copied to the new parent folder. The folder can only be copied to an active parent folder. The path of the folder and its children will be updated accordingly. The copy 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. Name uniqueness should be maintained under the target parent folder.

Note:

• The copy operation copies only the latest version not all versions
• ACLs are not copied when a folder is copied. The copied folder will have the same ACLs as the target folder.

Prerequisites

• Source folder and Target parent folder. To create a folder refer here

Request

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

• Headers:

  • Authorization: Bearer {tid token}

• Body:

  • targetParentId: The target parent identifier where the folder needs to be copied.

Example request body:

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

Response

Example Response:

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

To know more about the Copy folder API refer here.