Clear the folder¶

Clear the contents of the specified folder and its subfolders. This operation will delete files and subfolders. Please confirm the target folder before executing.

POST https://moi.matrixorigin.cn/newmoi/catalog/folder/clean

Preparation before calling¶

First query the file list to obtain the target folder ID. Prepare the personal access token, target workspace ID, and folder ID that have access to the target workspace.

The example below uses:

$AI_STUDIO_API_KEY: The actual personal access token, passed through the X-API-Key Header.
$WORKSPACE_ID: Target workspace ID, passed through X-Workspace-ID Header.
$FOLDER_ID: ID of the folder to be cleared.

The caller needs write access to the root volume.

Request example¶

curl -X POST "https://moi.matrixorigin.cn/newmoi/catalog/folder/clean" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "id": '"$FOLDER_ID"'
  }'

Request body¶

Parameter	Type	Required	Description
`id`	integer	Yes	Folder ID.

Successful response¶

Returns 200 on success, data is null. The caller needs write access to the root volume.

{
  "code": "OK",
  "msg": "OK",
  "data": null
}

The response fields are as follows.

Field	Type	Description
`code`	string	`OK` on success.
`msg`	string	`OK` on success.
`data`	null	Fixed to `null` when cleared successfully.

Error response¶

{
  "code": "ErrReadonly",
  "msg": "对象不可写",
  "data": null
}

Common HTTP errors¶

HTTP status code	error code	Common causes	Recommended actions
`400`	`ErrParamInvalid`	`id` is missing or the requested format is invalid.	Pass in a valid folder ID.
`403`	`ErrForbidden`	The current identity does not have write permissions to the root volume.	Use credentials with write access, or contact your administrator for authorization.
`409`	`ErrReadonly`	The database where the folder is located is not writable.	Select a folder in a writable volume.
`500`	`ErrServer`	The service cannot clear the folder.	Record the request time and error message and try again; if it continues to fail, contact support.

Follow-up operations¶

After completion, Query Catalog details confirms the current status.

Last updated on Sep 3, 2026