Get Chart Title from a Worksheet
This REST API retrieves the title of a chart that is stored in a worksheet of an Excel workbook.
Prerequisites: To call this endpoint you must have a valid Aspose.Cells Cloud OAuth2/JWT access token with the Cells.Read scope. The workbook must already be uploaded to the specified storage location.
REST API
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/title
Request parameters
| Parameter Name | Type | Location | Description |
|---|---|---|---|
| name | string | path | Name of the workbook file. |
| sheetName | string | path | Name of the worksheet that contains the chart. |
| chartIndex | integer | path | Zero‑based index of the chart. |
| folder | string | query | Folder path where the workbook is stored. |
| storageName | string | query | Name of the storage service. |
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.
Response fields
| Field | Description |
|---|---|
Title.Text |
The actual text displayed as the chart title. |
Title.Font.Name |
Font family used for the title (e.g., Arial). |
Title.Font.Size |
Font size in points. |
Title.Font.IsBold |
Indicates whether the title text is bold. |
Response status codes
| Code | Description |
|---|---|
| 200 OK | The chart title was retrieved successfully. |
| 401 Unauthorized | Authentication failed or token is missing/invalid. |
| 404 Not Found | The specified workbook, worksheet, or chart does not exist. |
| 500 Internal Server Error | An unexpected server error occurred. |
Notes: The chart index is zero‑based; ensure the chart exists. If the workbook has not been uploaded, upload it first using the appropriate API.
How to extract the title in a script (using jq)
# Assuming the JSON response is saved in response.json
title=$(jq -r '.Title.Text' response.json)
echo "Chart title: $title"
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 make calls to Aspose.Cells web services using various SDKs: