Uninstall a plugin¶
Delete the specified plugin installation while retaining its separate account connections.
DELETE https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/plugin-installations/{installation_id}
Before you call this API¶
Prepare the target workspace ID and a personal access token with access to the resource and the required action privileges. Use actual resource identifiers for workspace_id and installation_id in the path and also set X-Workspace-ID. Examples use jq to construct JSON; install it first. See Common objects and inputs for environment-variable sources.
Request body¶
curl -X DELETE "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/plugin-installations/$INSTALLATION_ID" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H 'Content-Type: application/json' \
--data-binary "$(jq -n --argjson INSTALLATION_VERSION "$INSTALLATION_VERSION" '
{
"expected_version": $INSTALLATION_VERSION
}
')"
Obtain the installation version from the latest details. Uninstall removes the installation record but retains separate account connections. Disconnect and delete connections through their own lifecycle.
Fields |
Type |
Required |
Description |
|---|---|---|---|
|
integer |
Yes |
Current connection or installation version; must be greater than 0. |
JSON objects reject unknown fields, duplicate keys, and multiple consecutive objects. Total request body size must not exceed 1 MiB.
Successful response¶
{
"code": 0,
"data": {
"status": "deleted"
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
Data returned by this operation. |
|
string |
Current state; interpret using this page’s conditions and common objects. |
Error response¶
Handle numeric business-error code, message, and details.reason separately from authorization-layer string codes. See Errors and states. On a state or version conflict, read the current resource first; do not automatically change identifiers or retry writes.