Cloud-based Excel File Management Solution – Detailed Explanation of Aspose.Cells Copy Folder API’s Batch Copy Functionality
Contents
[
Hide
]
Excel API: Copy Folder
Web API
PUT https://api.aspose.cloud/v4.0/cells/storage/folder/copy/{srcPath}
Function Description
The CopyFolder API duplicates an existing folder within Aspose.Cells Cloud storage. This is useful for creating backups, reorganising data, or preparing a folder hierarchy for further processing without manual file moves.
Security and Authentication
The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.
-H "Authorization: Bearer {access_token}"
The CopyFolder API accepts the following parameters
| Parameter Name | Required | Type | Location (Path/Query) | Description |
|---|---|---|---|---|
srcPath |
Yes | String | Path | The path of the source folder to copy. |
destPath |
Yes | String | Query | The path where the new folder will be created. |
srcStorageName |
No | String | Query | The name of the storage that contains the source folder. |
destStorageName |
No | String | Query | The name of the destination storage where the folder should be copied. |
### Sample Response
A successful call returns **HTTP 200** with an empty JSON body:
```json
{}
```
### Error Codes
| HTTP Status | Code | Meaning | Typical Cause |
| ----------- | ------------------- | --------------------------------- | --------------------------------------- |
| 400 | BadRequest | Missing or invalid parameters | `srcPath` or `destPath` not supplied |
| 401 | Unauthorized | Invalid or missing OAuth token | Token expired or not provided |
| 404 | NotFound | Source folder does not exist | Incorrect `srcPath` |
| 409 | Conflict | Destination folder already exists | `destPath` points to an existing folder |
| 500 | InternalServerError | Unexpected server error | Service outage or internal bug |
## OpenAPI Specification
The [OpenAPI Specification](https://reference.aspose.cloud/cells/#/FolderController/CopyFolder) defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.
## Excel API SDK
Using an SDK is the best way to speed up development. An SDK takes care of low‑level details and lets you focus on your project tasks. Please check out the [GitHub repository](https://github.com/aspose-cells-cloud) for a complete list of Aspose.Cells Cloud SDKs.
The following code examples demonstrate how to make calls to Aspose.Cells web services using various SDKs:
### Frequently Asked Questions
**Q: How do I copy a folder using Aspose.Cells Cloud API?**
A: Send a `PUT` request to `https://api.aspose.cloud/v4.0/cells/storage/folder/copy/{srcPath}` with the query parameters `destPath`, optional `srcStorageName` and `destStorageName`, and include an OAuth 2.0 Bearer token in the `Authorization` header. A successful call returns HTTP 200 with an empty JSON body (`{}`).
**Q: What authentication method is required for the CopyFolder API?**
A: The API requires OAuth 2.0. Obtain an access token via the Aspose Cloud authentication endpoint and pass it as `Authorization: Bearer <access_token>` in the request header.
**Q: What error codes can I expect when copying a folder?**
A: Common responses are `400 Bad Request` (missing parameters), `401 Unauthorized` (invalid token), `404 Not Found` (source folder not found), and `409 Conflict` (destination already exists). The response body contains a JSON error object with `Code` and `Message`.
**Q: Can I copy a folder between different storages?**
A: Yes. Use the optional `srcStorageName` and `destStorageName` query parameters to specify the source and destination storages.
**Q: Is there a size limit for the folder being copied?**
A: The API does not impose a specific size limit, but the request is subject to the overall storage quota and the service’s timeout settings.
This documentation was last updated on July 8, 2026.