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

Excel API: Get File Versions

Web API

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

Function Description

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.

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 Description

{
  "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"
      }
    }
  ]
}

Example response

{
  "Value": [
    {
      "VersionId": "1",
      "IsLatest": false,
      "ModifiedDate": "2024-01-15T12:34:56Z",
      "Size": 10240
    },
    {
      "VersionId": "2",
      "IsLatest": true,
      "ModifiedDate": "2024-03-01T08:22:10Z",
      "Size": 10300
    }
  ]
}

Error Handling

HTTP Status	Description	Typical Cause
401	Unauthorized – missing or invalid token	No `Authorization` header or bad key
403	Forbidden – insufficient permissions	Token lacks required scopes
404	Not Found – file or storage does not exist	Incorrect `path` or `storageName`
409	Conflict – version information unavailable	Concurrent modifications
500	Internal Server Error – unexpected failure	Server‑side issue

OpenAPI Specification

The OpenAPI Specification provides a comprehensive programming interface for executing REST interactions directly from a web browser.

Excel API SDK

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: