How to Delete a Pivot Table in an Excel Worksheet with Aspose.Cells Cloud

This REST API deletes a pivot table from a worksheet by its index.

Prerequisites – You must have a valid JWT access token for Aspose.Cells Cloud and the target Excel file stored in a supported storage location. Ensure the file name, worksheet name, and storage details are correctly specified before invoking the API.

Pivot tables are a powerful way to summarise data in an Excel worksheet. Using Aspose.Cells Cloud, you can programmatically remove an unwanted pivot table with a single HTTP DELETE request. This operation is ideal when you need to clean up worksheets, automate report generation, or integrate Excel manipulation into your applications.

REST API

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}

Request parameters

Parameter Name	Type	Location	Description
name	string	path	Name of the Excel document.
sheetName	string	path	Name of the worksheet that contains the pivot table.
pivotTableIndex	integer	path	Zero‑based index of the pivot table to delete.
folder	string	query	Path to the folder where the document is stored.
storageName	string	query	Name of the storage service.

The OpenAPI Specification defines a publicly accessible programming interface and allows you to carry out REST interactions directly from a web browser.

You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows how to make calls to the Cloud API with cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables/0" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK"
}

The response follows a simple JSON schema:

{
  "Code": integer,   // HTTP‑like status code of the operation
  "Status": string   // Textual description, e.g., "OK"
}

Error handling

HTTP Status	Description
400	Bad request – missing or invalid parameters.
401	Unauthorized – invalid or absent JWT token.
404	Not found – the file, worksheet, or pivot table does not exist.
500	Internal server error – an unexpected condition occurred on the server.

Cloud SDK Family

Using an SDK is the best way to speed up development. An SDK handles low‑level details and lets you focus on your project tasks. Please check out the GitHub repository 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:

Convert table to pivot table Delete All Pivot Tables in an Excel Worksheet