Copy a file

To copy a file, send a request with a id parameter for the file to copy and target parent id that defines the location to be copied.

Note:

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

Prerequisites

• A space should be created. To know more about creating a space refer here
• To copy a file, source file ID and target folder ID is needed. To create folder refer here

Request

POST {baseUrl}/spaces/{spaceId}/files/{fileId}/copy

• HEADER:

  • Authorization: Bearer {tid token}

• BODY:

  • targetParentId - Parent id for the file where it needs to be copied

Example Request

{
       "targetParentId": "2c4a6b7d-6ce0-4084-a1f2-ab28e8ef266c"
   }

Response

Example response:

{
       "createdAt": "2024-06-24T12:24:49Z",
       "createdByTrn": "trn:tid:application:<applicationId>",
       "id": "c970a123-83ad-4c86-975f-2113fffdd574",
       "message": "Awaiting execution",
       "status": "QUEUED",
       "type": "COPY"
   }

It will return a job response with status as QUEUED, once the source file is copied successfully to the target then it will return the copied file id as target_id in job response result attribute.

Example response:

{
       "createdAt": "2024-06-24T12:24:49Z",
       "createdByTrn": "trn:tid:application:<applicationId>",
       "id": "c970a123-83ad-4c86-975f-2113fffdd574",
       "message": "{\"target_id\": \"d7eea0cc-4064-46d4-af16-cb93daf35cb0\", \"target_name\": \"Hettingerstad\"}",
       "status": "COMPLETED",
       "type": "COPY"
   }

To know more about the Copy file API refer here.