Create an Empty Excel Workbook using Aspose.Cells Cloud API
REST API
This REST API creates an empty workbook.
PUT https://api.aspose.cloud/v3.0//cells/{name}
Security and Authentication
The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.
Query Parameters
| Parameter Name | Type | Description |
|---|---|---|
| templateFile | string | Path to a template workbook to use as a base (optional). |
| dataFile | string | Path to a data file for populating the workbook (optional). |
| isWriteOver | boolean | true to overwrite an existing file; false otherwise. |
| folder | string | Destination folder for the created workbook (optional). |
| storageName | string | Name of the storage service to use. |
Request Body Parameter
| Parameter Name | Type | Description |
|---|---|---|
| data | file | Binary content of the workbook file to create. |
Response
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
HTTP Status Codes
| Code | Meaning | When Returned |
|---|---|---|
| 200 OK | Workbook created successfully | Normal flow |
| 201 Created | Workbook created (alternative response) | When the API returns a created status |
| 400 Bad Request | Invalid parameters | Client‑side error |
| 401 Unauthorized | Missing or invalid token | Authentication error |
| 409 Conflict | File exists and isWriteOver=false |
Conflict with existing file |
How to Use the PutWorkbookCreate API with SDKs
PutWorkbookCreate API Specification
The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.
You can use the cURL command‑line tool to access Aspose.Cells web services. Include the Authorization header with a valid OAuth2/JWT access token. For example, obtain your token from the authentication endpoint and use it in the header as shown below.
Use Aspose.Cells Cloud SDKs
Using an SDK is the best way to speed up development. An SDK abstracts low‑level details so you can focus on your project tasks. Check the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.
The following code examples demonstrate how to call Aspose.Cells web services using various SDKs: