Add a shape on an Excel worksheet

This REST API adds a shape to an Excel worksheet.

REST API

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

The request parameters are:

Parameter Name	Type	Location	Description
name	string	path	Document name.
sheetName	string	path	Worksheet name.
shapeDTO	object	body	JSON object that describes the shape to be added.
drawingType	string	query	Shape object type (e.g., `arc`, `line`, `rectangle`).
upperLeftRow	integer	query	Upper‑left row index of the shape.
upperLeftColumn	integer	query	Upper‑left column index of the shape.
top	integer	query	Vertical offset of the shape from its top edge, in pixels.
left	integer	query	Horizontal offset of the shape from its left edge, in pixels.
width	integer	query	Width of the shape, in pixels.
height	integer	query	Height of the shape, in pixels.
folder	string	query	Folder that contains the document.
storageName	string	query	Name of the storage.

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 make a call to the Cloud API with cURL.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes?DrawingType=arc&upperLeftRow=1&upperLeftColumn=1&top=1&left=1&width=100&height=100" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

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

Cloud SDK Family

Using an SDK is the best way to speed up development. An SDK handles low‑level details so you can 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 call Aspose.Cells web services using various SDKs:

Update a shape on an Excel worksheet