Help Center/ KooDrive/ API Reference/ API/ Multiple File Versions/ Modifying the Version Information of a Specified File or Version ID

Updated on 2025-10-22 GMT+08:00

View PDF

Modifying the Version Information of a Specified File or Version ID

Function

Modify the version information of a specified file or version ID. Note: This field is used only to determine whether the version is permanently retained.

Authorization Information

No identity policy-based permission required for calling this API.

URI

POST /koodrive/ose/v1/revision/updateRevision

Request Parameters

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
Authorization	Yes	String	Access token. Token authentication is used to call KooDrive APIs. A token indicates the permission. When an API is called, the token is added to the request header to obtain the operation permission. For details about how to obtain an access token, see the corresponding developer guide. The format is Bearer+{access_token}.
X-User-Id	Yes	String	User ID, which is used for app authentication.
X-Date	Yes	String	Date, which is used for app authentication.
Host	Yes	String	Address, which is used for app authentication.
X-Traceid	No	String	Message log trace ID. The value contains 58 bits.

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
containerId	Yes	String	Space ID.
fileId	Yes	String	File ID.
revisionId	Yes	String	assetId + versionId of the file.
keepForever	Yes	Boolean	Whether to retain the data permanently. Value: true or false. The platform automatically clears the data based on rules.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
code	String	Response code.
msg	String	Response message.

Example Requests

Modify the version information of a specified file or version ID.

POST /koodrive/ose/v1/revision/updateRevision

Authorization:Bearer+10f88d07fa************44791e9ff

{
  "containerId": "IAAFotBZGfP8nAncA1605110969531523201",
  "fileId": "FqX2B_dehFwue-TwoyUZKr787_QLwo2AL",
    "revisionId": "1618739290026578816.1763131768673766528",
    "keepForever": true
}