Delete a workspace¶

Delete a specified workspace. Before deleting it, confirm that it is no longer needed and complete any required data-sharing cleanup. After a successful response, list workspaces to confirm that it no longer appears.

DELETE https://moi.matrixorigin.cn/newmoi/workspaces/{id}

Before you call this API¶

Identify the workspace to delete. Prepare a personal access token and the workspace ID.

The following example uses:

$AI_STUDIO_API_KEY: Your personal access token, passed in the X-API-Key header.
$WORKSPACE_ID: The workspace ID to delete, passed in the URL path.

If the workspace has associated data-sharing cleanup requirements, complete them before deletion.

Request example¶

curl -X DELETE "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY"

Path parameters¶

Parameter	Type	Required	Description
`id`	string	Yes	ID of the workspace to delete.

Successful response¶

On success, the API returns 200, indicating that the service accepted the deletion. This response does not replace a subsequent list check.

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

Response fields:

Field	Type	Description
`code`	string	`OK` on success.
`msg`	string	`OK` on success.

Error response¶

{
  "code": "ErrWorkspaceNotFound",
  "msg": "Workspace not found",
  "data": null
}

Common HTTP errors¶

HTTP status	Error code	Common cause	Recommended action
`400`	`INVALID_ARGUMENT`	The workspace ID is invalid.	Check the workspace ID in the path and retry.
`401`	`Unauthorized` or `UNAUTHENTICATED`	Credentials are missing or invalid.	Check the personal access token.
`403`	`ErrUserNotSynced` or `PERMISSION_DENIED`	The current identity has not been synchronized or cannot delete workspaces.	Complete account synchronization, or ask an administrator for access before retrying.
`404`	`ErrWorkspaceNotFound`	The workspace does not exist, or the current identity cannot access it.	Check the workspace ID and the current identity’s permissions.
`409`	`data_share_workspace_delete_blocked`	The workspace’s data-sharing cleanup is incomplete.	Complete the data-sharing cleanup, then retry deletion.
`503`	`data_share_workspace_delete_unavailable` or `UNAVAILABLE`	The data-sharing precheck or a dependent service is temporarily unavailable.	Retry later.
`500`	`ErrWorkspaceDeleteFailed`	The service could not delete the workspace.	Record the request time and error message, then retry.

Next steps¶

Use the workspace name to list workspaces. Confirm the deletion only after the workspace no longer appears in the list.

Last updated on Sep 3, 2026