Copy File/Folder

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

This API copies a collection of files or folders from one destination to another.

Endpoints

OAuth Scope

WorkDrive.files.CREATECopied!

Request Example

cURL
cURL
Deluge
Copied!
curl --request POST \
  --url https://www.zohoapis.com/workdrive/api/v1/files/{resource_id}/copy \
  --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: application/vnd.api+json' \
  --data '{"data":{"attributes":{"resource_id":"jxtee81865c6d7ed64dc596540aa30dfd2753"},"type":"files"}}'

Path Parameters

resource_idstring(Required)

The unique ID of the destination folder.

Request Body

application/vnd.api+json
dataJSON Object(Required)
Hide Sub-Attributes
attributesJSON Object(Required)
Hide Sub-Attributes
resource_idstring(Required)

The unique ID of the source file/folder.

typestring(Required)

The JSON:API resource type. Always "files".

Allowed Values :
Show Values
filesCopied!
Copied!Copy all as JSON Array

Body Parameters

Copied!
  {
    "data": {
      "attributes": {
        "resource_id": "jxtee81865c6d7ed64dc596540aa30dfd2753"
      },
      "type": "files"
    }
  }
                
Show full

Response Example

R004

R004

R506

F7003

R008

R008

F7004

R602

R602

R512

R511

F000

R604

R517

200
200
400
401
403
500
Copied!
  {
    "data": [
      {
        "id": "jxtee2f2b3ba636c542119b14bd1a105aa73c",
        "type": "files",
        "attributes": {
          "modified_by_zuid": "747938014",
          "is_locked": false,
          "conv_engine_type": 0,
          "is_fillable_resource": false,
          "is_published": false,
          "destination_id": "ly9zm3bd32ac7cfdd45448e435bd20a6be500",
          "storage_info": {
            "files_count": 0,
            "folders_count": 0,
            "size_in_bytes": 0,
            "storage_used_in_bytes": 0
          },
          "type": "file",
          "created_time_i18": "Apr 14, 4:59 PM",
          "modified_time_in_millisecond": 1618400166972,
          "opened_time": "Apr 14, 5:06 PM",
          "status_change_time": "Apr 14, 5:06 PM",
          "download_url": "https://download-accl.zoho.com/v1/workdrive/download/jxtee2f2b3ba636c542119b14bd1a105aa73c",
          "comment_badge_count": 0,
          "is_app_associated": false,
          "created_time": "Apr 14, 4:59 PM",
          "lock_status": 2,
          "is_folder": false,
          "resource_type": 2506,
          "is_email_in_upload": false,
          "display_attr_name": "reports.zip",
          "user_access_time": "Apr 14, 4:59 PM",
          "created_by": "Zylker Creation",
          "display_html_name": "reports.zip",
          "labels": [],
          "user_access_time_i18": "Apr 14, 4:59 PM",
          "org_id": "ly9zmae16b43c258f458a9a57ac02c4f8d763",
          "parent_id": "ly9zm3bd32ac7cfdd45448e435bd20a6be500",
          "name": "reports.zip",
          "status_change_time_in_millisecond": 1618400166972,
          "permalink": "https://www.zohoapis.com/workdrive/file/jxtee2f2b3ba636c542119b14bd1a105aa73c",
          "favorite": false,
          "new_badge_count": 0,
          "status": 1,
          "modified_time_i18": "Apr 14, 5:06 PM",
          "opened_time_i18": "Apr 14, 5:06 PM",
          "extn": "zip",
          "user_access_time_in_millis": 1618399762132,
          "shortcut_link": "",
          "status_change_time_i18": "Apr 14, 5:06 PM",
          "description": "",
          "uploaded_time_in_millisecond": 1618400166895,
          "thumbnail_url": "https://download-accl.zoho.com/v1/workdrive/thumbnail/jxtee2f2b3ba636c542119b14bd1a105aa73c",
          "title": "",
          "modified_time": "Apr 14, 5:06 PM",
          "library_id": "ly9zm0170fb40015f4e2297a144e2b68cfa68",
          "icon_class": "zip",
          "created_time_in_millisecond": 1618399761943,
          "owner": "747937818",
          "creator": "747938014",
          "capabilities": {
            "can_read": true,
            "can_share": true,
            "can_remove_share": false,
            "can_delete": false,
            "can_edit": true,
            "can_upload_files": true,
            "can_trash": true,
            "can_rename": true,
            "can_restore": false,
            "can_copy": true,
            "can_move": true,
            "can_zip": true,
            "can_download": true,
            "can_emailattach": true,
            "can_publish": true,
            "can_create_task": true,
            "can_share_support": true,
            "can_label": true,
            "can_delist_file": false,
            "can_checkout": true,
            "can_cancel_checkout": false,
            "can_discard_checkout": false,
            "can_checkin": false,
            "can_read_comment": true,
            "can_create_comment": true,
            "can_trash_files": true
          },
          "uploaded_time_i18": "Apr 14, 5:06 PM",
          "is_external_upload": false,
          "watch_preference": {
            "watch": false,
            "notifyemail": false,
            "notifybell": false
          },
          "opened_time_in_millisecond": 1618400166895,
          "edit_badge_count": 0,
          "share_data": [],
          "data_template_id_to_mandate": "",
          "uploaded_time": "Apr 14, 5:06 PM",
          "has_folders": false,
          "service_type": "upload",
          "recent_action": "last_modified_time",
          "display_url_name": "reports.zip",
          "is_unread": false,
          "modified_by": "Zylker Creation",
          "embed_props": {}
        },
        "relationships": {
          "folders": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/folders",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/folders"
            }
          },
          "comments": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/comments",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/comments"
            }
          },
          "previewinfo": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/previewinfo",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/previewinfo"
            }
          },
          "unzip": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/unzip",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/unzip"
            }
          },
          "publiclink": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/publiclink",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/publiclink"
            }
          },
          "resourceproperty": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/resourceproperty",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/resourceproperty"
            }
          },
          "parentfolders": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/parentfolders",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/parentfolders"
            }
          },
          "shortcut": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/shortcut",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/shortcut"
            }
          },
          "importfile": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/importfile",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/importfile"
            }
          },
          "versions": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/versions",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/versions"
            }
          },
          "supportshare": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/supportshare",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/supportshare"
            }
          },
          "permissions": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/permissions",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/permissions"
            }
          },
          "timeline": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/timeline",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/timeline"
            }
          },
          "files": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/files",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/files"
            }
          },
          "saveastemplate": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/saveastemplate",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/saveastemplate"
            }
          },
          "links": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/links",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/links"
            }
          },
          "copy": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/copy",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/copy"
            }
          },
          "previewzip": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/previewzip",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/previewzip"
            }
          },
          "tasks": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/tasks",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/tasks"
            }
          },
          "breadcrumbs": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/breadcrumbs",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/breadcrumbs"
            }
          },
          "entity": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/entity",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/entity"
            }
          },
          "custommetadata": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/custommetadata",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/custommetadata"
            }
          },
          "statistics": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/statistics",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/statistics"
            }
          },
          "appdata": {
            "links": {
              "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/relationships/appdata",
              "related": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c/appdata"
            }
          }
        },
        "links": {
          "self": "https://www.zohoapis.com/workdrive/files/jxtee2f2b3ba636c542119b14bd1a105aa73c"
        }
      }
    ],
    "meta": {
      "search_result_count": 0,
      "action_id": "2774428000000022007"
    }
  }
                
  {
    "errors": [
      {
        "id": "R004",
        "title": "Invalid resourceId"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R506",
        "title": "Copy into the same resource or its sub resource not allowed."
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F7003",
        "title": "Invalid OAuth token"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R008",
        "title": "Insufficient permissions"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F7004",
        "title": "Invalid OAuth scope"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R602",
        "title": "Invalid parent Id."
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R512",
        "title": "Storage limit exceeded copy is not permitted."
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R511",
        "title": "My Space storage limit exceeded, cannot copy resource into my folder."
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "F000",
        "title": "General exception"
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R604",
        "title": "Copy destination cannot be a file."
      }
    ]
  }
                
  {
    "errors": [
      {
        "id": "R517",
        "title": "Copy action failed as storage limit exceeded in the destination Team Folder."
      }
    ]
  }
                
Show full