Change Column Widths Inside a Range

This REST API sets the column width of a range.

REST API

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/columnWidth

Prerequisites – Before calling the endpoint you must:

Create an Aspose Cloud account and obtain a client ID and client secret.
Request a JWT token by calling the OAuth endpoint (/connect/token). The token is returned in the access_token field.
Upload the target workbook to your Aspose Cloud storage (or ensure it already exists in the specified folder).

The request parameters are:

Parameter Name	Type	Location	Description
name	string	path	Name of the workbook file
sheetName	string	path	Name of the worksheet
value	number	query	Desired column width value
range	object	body	Range object that defines the target cells
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 calls to the Cloud API with cURL.

Request

# Call the column‑width endpoint for workbook *test.xlsx*,
# worksheet *Sheet1*, setting the width of the selected columns to 20 points.
curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/columnWidth?value=20" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "ColumnCount": 7,
        "ColumnWidth": 19,
        "FirstColumn": 0,
        "FirstRow": 9,
        "Name": "string",
        "RefersTo": "string",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }'

Response

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

Possible error responses

HTTP Code	Description
400	Bad Request – invalid JSON or parameters
401	Unauthorized – missing or invalid token
404	Not Found – workbook or worksheet absent

Cloud SDK Family

Using an SDK is the best way to accelerate 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:

FAQ

Q: What endpoint do I call to set the column width of a range in an Excel workbook?
A: POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/columnWidth where {name} is the workbook file name and {sheetName} is the target worksheet.

Q: How do I authenticate the request when using the column‑width API?
A: Include an Authorization: Bearer <jwt token> header. Obtain the JWT token via the Aspose Cloud OAuth flow (/connect/token) using your client ID and client secret.

Q: What JSON body should I send to change the width of columns A‑C to 25 points?
A:

{
  "FirstColumn": 0,
  "ColumnCount": 3,
  "FirstRow": 0,
  "RowCount": 1
}

Add the query parameter value=25 to the request URL.

Set Range Value in an Excel Worksheet Set Row Height for a Range in Excel – Aspose.Cells Cloud API (v3.0)