Add Condition to Conditional Formatting

This API adds a new condition to an existing conditional formatting rule.

Rest Api

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/conditionalFormattings/{index}/condition

Request Parameters

Parameter Name	Type	Location	Description
name	string	path	Name of the workbook file.
sheetName	string	path	Name of the worksheet.
index	integer	path	Index of the conditional formatting collection.
type	string	query	Type of the condition (e.g., CellValue, Expression).
operatorType	string	query	Operator used for the condition (e.g., Equal, GreaterThan).
formula1	string	query	First formula or value for the condition.
formula2	string	query	Second formula or value (used with some operators).
folder	string	query	Folder in storage where the workbook is located.
storageName	string	query	Name of the storage service.

Note: name, sheetName, index, type, operatorType, and formula1 are required. All other parameters are optional.

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/conditionalFormattings/0/condition?type=CellValue&operatorType=Equal&formula1=v1&formula2=v2" \
-X PUT \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Response

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

Error Responses

HTTP Code	Reason	Example Body
400	Bad Request – missing or invalid parameters.	`{ "Code":"400", "Message":"Invalid parameter value." }`
401	Unauthorized – missing or invalid JWT token.	`{ "Code":"401", "Message":"Access token is missing or invalid." }`
404	Not Found – workbook or worksheet does not exist.	`{ "Code":"404", "Message":"File not found." }`
500	Internal Server Error – unexpected server failure.	`{ "Code":"500", "Message":"An unexpected error occurred." }`

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 call Aspose.Cells web services using various SDKs:

Add CellArea to Conditional Formatting Add Format Condition