Updated on 2026-04-16 GMT+08:00

API Overview

Table 1 describes the KooDrive APIs.

Table 1 API overview

Type

API

Description

User Management

Querying User Information

Query information about a user.

Modifying a User Status (Freezing/Unfreezing)

Modify information about a user.

Deleting a User

Delete a user and the corresponding resources.

Space Management

Querying Space Information

Query individual space information.

Deleting a Space

Delete a space.

Modifying Space Information

Modify individual space information.

Querying Space Usage Overview

Query space usage overview, total number, total space capacity, and used total space.

Querying Space Usage by Quota

Query the total allocated quota, total space, and total used space by allocated quota.

Querying Space Usage by User

Query user space details by user.

Shared Folder Management

Creating a Shared Folder

Create a shared folder.

Deleting a Shared Folder

Delete a shared folder.

Viewing the Shared Folders I Created or Joined

View the shared folders I created or joined.

Renaming a Shared Folder

Rename a shared folder.

Viewing Details About a Shared Folder

View details about a shared folder.

Member Management of a Shared Folder

Inviting a Member to Join a Shared Folder

Invite a member to join a shared folder.

Removing a Member from a Shared Folder

Remove a member from a shared folder.

Viewing the List of Invitees

View the list of invitees.

Viewing Invitation Details

View invitation details.

Listing Members in a User Group

List members in a group.

Editing the Alias of a Group Member

Edit the alias of a group member.

Confirming Whether to Join a Shared Folder

Confirm whether to join a shared folder.

Viewing the Pending Invitation List

View the pending invitation list.

Managing Notifications

Updating the Notification Status to Read

Update the notification status to read.

Querying Unread Notifications

Query unread notifications.

Audit Log Management

Querying Audit Logs

Query audit logs.

Device Binding

Unbinding Devices

Unbind devices.

Listing Bound Devices

List devices bound to a user.

Binding Devices to a User

Bind devices to a user.

Configuration Management

Viewing Configuration Information

View the module configuration information.

Listing Configuration Information

List all configuration information of a specified module.

Adding Configuration Information

Add the module configuration information.

Modifying Configuration Information

Modify the module configuration information.

Backup Scope

Adding Backup Scopes

Add backup scopes of modules in batches.

Deleting Backup Scopes

Delete backup scopes of modules in batches.

Listing Backup Scopes

List backup scopes.

Backup Records

Creating a Backup Record

Create a backup record.

Completing the Backup

Complete the backup.

Deleting a Backup Record

Delete a backup record. The backup file is also deleted.

Viewing Backup Records

View backup records.

Listing Backup Files

List backup files.

Creating a Backup File

Create a backup file.

Listing Backup Records

List backup records.

Creating a Backup Lock

Create a backup lock with an expiration time of 10 minutes.

Backup Lock Renewal

Backup lock renewal. The renewal duration for an expired backup lock starts from the expiration time.

Releasing a Backup Lock

Release a backup lock.

Album Management

Creating an Album

Create an album.

Updating an Album

Update an album, including updating the album collection scope and type, and updating the name of the manual album.

Deleting an Album

Delete an album.

Viewing an Album

View an album (album list).

Listing Album Files

List album files.

Adding Album Content

Add album content. Add associated content to the manual album, instead of uploading files.

Deleting Album Contents in Batches

Remove contents from a manual album without deleting the original files.

Carrier Reconciliation

Exporting Bill Information

Export bill information.

Checking Data (Reconciliation)

Check data. Carriers can download the reconciliation import template from the KooDrive official website, fill in data, and call this API to check data.

Querying the Reconciliation Discrepancy List

Query the reconciliation discrepancy list based on the reconciliation batch number returned by the data check API.

User registration and provisioning

Registering a New User

Register a user.

Creating a Batch Provisioning Task

Create a batch provisioning task.

Querying Batch Provisioning

Query batch provisioning.

Verification code

Verifying a Verification Code

Verify the verification code.

Account and password management

Resetting a Password

Reset the password.

Changing a Password

Change a password.

Modifying User Information

Modify user information.

Querying User Information

Query user information.

Deregistering Users

Deregister a user.

Login and logout

Login

Log in to the system.

Logout

Log out of the system.

Refresh Token

Refresh authentication.

Cloud Decompression

Listing Compressed Package Directories

List compressed package directories. Data files need to be loaded to the Singapore node for processing.

Batch Task Operations

Listing Batch Tasks

List batch tasks.

Creating a Batch Task

Create a batch task.

Querying Details About a Batch Task

Query details about a batch task.

Canceling a Batch Task

Cancel a batch task whose status is 0 (to be processed) or 1 (processing). After the task is canceled, the task scheduling module ignores its record.

Benefit Distribution

Notifying a User that a Package Expires and Enters the Grace or Retention Period

Notify a user that the package expires and enters the retention period. This function can be called only after the whitelist is added.

Carrier Reverse Notification API – Pay-per-Use

Carrier reverse notification API – pay-per-use.

Multiple File Versions

Modifying the Version Information of a Specified File or Version ID

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

Obtaining the Version Information of a Specified File or Version ID

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

Deleting the Version Information of a Specified File or Version ID

Delete the version information of a specified file or version ID. Note: The latest version cannot be deleted. Only historical versions can be deleted.

Creating Multiple Historical Versions

Create multiple historical versions.

Restoring the Version Information of a Specified File or Version ID

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

Listing All Versions of a Specified File

List all version information of a specified file.

Checking Whether File Upload Is Completed

This API is called after the complete data of a file is uploaded. The API checks the file integrity. If the file passes the check, the file upload is complete.

Carrier Calling APIs

Obtaining the Retention Period Policy Configuration List

Obtain the retention period policy configuration list.

Setting a Carrier Retention Period Policy

Set a new carrier retention period policy.

Querying a Carrier Retention Period Policy

Query a carrier's retention period policy.

File List Query

Listing Files in the Individual Space

List files in an individual space.

File Management

Obtaining File Details

Obtain file details, such as the file size, name, and modification time.

Obtaining File Operation Records

Obtain the operation record list of a file.

Adding a File Directory

Add a file directory.

Creating File Metadata

Create the metadata of the uploaded file. If flash upload is not hit, the upload process is triggered. If flash upload is hit, the file upload is complete. Data files need to be loaded to the Singapore node for processing.

Obtaining an Upload Link

Generate the upload link of a file part for multipart upload.

Checking Whether File Upload Is Completed

Check the file integrity after the service uploads the complete data of a file. If the file passes the check, the file upload is complete. Data files need to be loaded to the Singapore node for processing.

Obtaining a Download Link

Obtain the download links of files.

Renaming a File

Rename a file.

Adding a Custom Tag to a File

Add a custom tag to the file, overwriting the existing tag with the same name.

Clearing the Recycle Bin

Create an asynchronous task to clear all files in the recycle bin of the space.

Retrieving Files Using Search Engine Capabilities

You can search for files or folders in the cloud space by file name or type.

Collecting Folder Statistics

Collect statistics on the number of directories, number of files, and total file size in a folder.

Obtaining the Full Name and ID Paths of a File

Obtain the full name and ID paths of a file.

Generating a Document Thumbnail

Generate a document thumbnail.

Generating a Video Thumbnail

Generate a video thumbnail.

Deleting a Custom Tag of a File

Delete a custom tag of a file.

File Operations

Obtaining the Preview Link of a File

Obtain the link for previewing a file.

Obtaining the Preview Link of a Shared File

Obtain the link for previewing a shared file.

File Favorites

Adding Files to Favorites

Add files to favorites or remove files from favorites. Up to 100 files are supported.

Listing Files in Favorites

List files in favorites. Up to 100 files are supported each time.

Sharing Management - Shared by You

Sharing a File

Share a file.

Obtaining Sharing Details

Obtain sharing details.

Listing My Shares

List files shared by you. One sharing record occupies one line. When multiple files are shared, a folder with the first file name is displayed. When a single file is shared, the file information is displayed.

Modifying Sharing Settings

Modify sharing settings.

Stopping Sharing Files

Stop sharing files.

Sharing Management - Access Links

Creating an Asynchronous Sharing Task

Create an asynchronous sharing task.

Querying Details About an Asynchronous Task

Query the details about an asynchronous task.

Related to Me

Listing Related Files

List the files related to you.

Listing Recently Visited Files

List the files that you recently visited.

Sharing Management - Access Links - Public

Accessing a Sharing Link

Access a sharing link shared by other users. (This function is available only to whitelisted users.)

Obtaining Sharing Information

Obtain the shared link information. (This function is available only to whitelisted users.)

Verifying a Sharing Access Code

Verify a sharing access code. (This function is available only to whitelisted users.)

Listing Shared Files

List shared files. (This function is available only to whitelisted users.)

Downloading a File

Obtain the download address of a single file in the sharing link. (This function is available only to whitelisted users.)