List plugin releases¶
List visible system or workspace plugin releases.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/plugin-releases
Before you call this API¶
Prepare the target workspace ID and a personal access token with resource access and permission for this action. Use the actual resource workspace_id in the path and X-Workspace-ID. See common objects and inputs for environment variable sources.
Query parameters¶
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/plugin-releases" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--get \
--data-urlencode "namespace=$RELEASE_NAMESPACE" \
--data-urlencode "limit=20" \
--data-urlencode "offset=0"
Set $NEXT_OFFSET to the original offset plus the number of items on this page. Request the next page only while it remains below total.
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/plugin-releases" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--get \
--data-urlencode "namespace=$RELEASE_NAMESPACE" \
--data-urlencode "limit=20" \
--data-urlencode "offset=$NEXT_OFFSET"
Save the release id and selected namespace, then get release details. Continue with offset plus the current items count until reaching total. Stop on an empty page and recheck the list.
Field |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes |
system or workspace; no default. |
|
integer |
No |
1–100 entries per page, default 20. The parameter may appear only once. |
|
integer |
No |
Zero-based offset, default 0. Must not be negative or appear more than once. |
|
string |
No |
Search release names or descriptions. |
Successful response¶
{
"code": 0,
"data": {
"items": [],
"total": 0
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
Data returned by this action. |
|
array |
Results on this page; read fields according to the resource object. |
|
integer |
Total records matching the current filters. |
Error responses¶
Handle business errors with numeric code, message, and details.reason separately from authorization-layer errors with string codes. See errors and states. On state or version conflicts, read the current resource before changing identifiers or retrying writes.