List plugin installations

List plugin installations visible to the current user.

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/plugin-installations

Before you call this API

Prepare the target Workspace ID and a personal access token that can access the resources and perform this operation. Use the actual resource identifier for workspace_id in the path, and also supply the Workspace ID in X-Workspace-ID. See Shared objects and inputs for environment variable sources.

Query parameters

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/plugin-installations" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=0"

Set $NEXT_OFFSET to the previous offset plus the current page’s items count. Request another page only while it is less than total.

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/plugin-installations" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=$NEXT_OFFSET"

Returns installations visible to the current user, filtered by permissions. Paginate using offset and total; retain installation versions for later updates and deletion.

Field

Type

Required

Description

limit

integer

No

1–100 items per page, default 20. Each parameter name may appear only once.

offset

integer

No

Zero-based offset, default 0; must not be negative. Each parameter name may appear only once.

Successful response

{
  "code": 0,
  "data": {
    "items": [],
    "total": 0
  }
}

Field

Type

Description

code

integer

0 on success.

data

object

Data returned by this operation.

data.items

array

Results on this page; read fields according to the resource object.

data.total

integer

Total records under current filters.

Error responses

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