Cloud‑Based Excel Management – Quickly Retrieve File Version History in Aspose.Cells Cloud

Retrieve a complete list of version records for a specific spreadsheet stored in Aspose.Cells Cloud. This endpoint enables developers to track changes, audit modifications, and implement version‑control workflows directly from the cloud storage.

The GetFileVersions API returns all version records for a specified spreadsheet stored in Aspose.Cells Cloud. It helps you keep a complete change history for each file.

Excel API: Get File Versions

Web API

GET https://api.aspose.cloud/v4.0/cells/storage/version/{path}

Security and Authentication

The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.

The request parameters of GetFileVersions API are

Parameter Name Type Location Description
path String Path Required. Full path to the file whose versions are being retrieved.
storageName String Query Optional. Name of the storage containing the file. If omitted, the default storage is used.

Response

{
  "Name": "FileVersions",
  "Description": [
    "Contains a list of file versions for the specified document."
  ],
  "Type": "Class",
  "IsAbstract": false,
  "Properties": [
    {
      "Name": "Value",
      "Description": ["A collection of file version details."],
      "Nullable": true,
      "ReadOnly": false,
      "IsInherit": false,
      "DataType": {
        "Identifier": "Container",
        "Reference": "FileVersion",
        "ElementDataType": {
          "Identifier": "Class",
          "Reference": "FileVersion",
          "Name": "class:fileversion"
        },
        "Name": "container"
      }
    }
  ]
}

On success, the API returns HTTP 200 OK with a JSON payload containing the Value array of file‑version objects, as illustrated above.

HTTP Status Codes

Code Meaning Description
200 OK Filter applied successfully; response contains operation details.
400 Bad Request Missing or invalid parameters (e.g., unsupported file type).
401 Unauthorized Invalid or missing JWT token.
413 Payload Too Large Uploaded file exceeds size limit.
500 Internal Server Error Unexpected server error.

OpenAPI Specification

The OpenAPI Specification provides a comprehensive programming interface for executing 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.

Use Aspose.Cells Cloud SDKs

Utilizing an SDK streamlines development by abstracting low‑level complexities, allowing developers to focus on core functionalities. Explore the GitHub repository for a full list of Aspose.Cells Cloud SDKs.

The following code examples illustrate how to interact with Aspose.Cells web services across various programming languages:

Delete Folder – Aspose.Cells Cloud API | Remove Folders via REST