Add watermark to Excel files

This REST API adds a watermark to Excel files.

REST API

POST https://api.aspose.cloud/v3.0/cells/watermark

The request parameters are:

Parameter Name	Type	Location	Description
`file`	file	formData (multipart body)	The Excel file to which the watermark will be applied.
`text`	string	query	The watermark text to display.
`color`	string	query	The watermark colour in ARGB hex format (e.g., `004433ff`).

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 call Aspose.Cells web services. The example below shows a complete request, including the required authentication header. Replace <your‑jwt‑token> with a valid JWT access token obtained from the Aspose authentication endpoint.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/watermark?text=aspose.cells.cloud&color=004433ff" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your-jwt-token>" \
  -F "file=@Sample.xlsx"

Response

{
  "Files": [
    {
      "Filename": "Sample_watermarked.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

The JSON response contains a Files array. For each file object:

Filename – name of the processed workbook.
FileSize – size of the file in bytes.
FileContent – Base64‑encoded content of the watermarked Excel file; decode it to obtain the actual file.

Cloud SDK Family

Using an SDK is the fastest way to develop. An SDK abstracts low‑level details, allowing you to focus on your business logic. 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 Background Image to Workbook