Add multiple rows to an Excel worksheet using Aspose.Cells Cloud API

This REST API adds several new rows to an Excel worksheet.

PutInsertWorksheetRows API

PUT http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows

Security and Authentication

The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.

Request parameters

Parameter Name	Type	Location	Description
name	string	path	The workbook name.
sheetName	string	path	The worksheet name.
startrow	integer	query	The index of the first row to be inserted (0‑based).
totalRows	integer	query	The number of rows to insert.
updateReference	boolean	query	Whether to update cell references after insertion (`true` or `false`).
folder	string	query	The folder that contains the document.
storageName	string	query	The storage name.

Prerequisites
The workbook must already exist in the specified storage (or folder) before invoking this operation.

Authentication
The API requires a valid JWT token. Include it in the Authorization header as shown in the cURL example below.

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 easily. The following example shows how to call the Cloud API with cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows?startrow=1&totalRows=11&updateReference=true" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Note: This PUT operation does not require a request body; an empty JSON object ({}) can be sent if the client library forces a payload.

Response

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

Possible response codes

200 OK – Rows inserted successfully.
400 Bad Request – Invalid parameters (e.g., negative row index).
401 Unauthorized – Missing or invalid JWT token.
404 Not Found – Specified workbook or worksheet does not exist.
500 Internal Server Error – Unexpected server error.

For further operations on rows, see the related pages: Delete rows, Get rows, and Copy rows.

Cloud SDK Family

Using an SDK is the fastest way to develop. An SDK handles low‑level details so you can focus on your project. Please 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: