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

expected_version

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

code

integer

0 on success.

data

object

Data returned by this operation.

data.status

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.

Last updated on