Search plugin capabilities¶
Search capabilities from installed or installable plugins.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/plugin-discovery/search
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-discovery/search" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--get \
--data-urlencode "q=$PLUGIN_QUERY" \
--data-urlencode "availability=all" \
--data-urlencode "limit=5"
Only when has_more=true, set $NEXT_CURSOR to the returned next_cursor and continue.
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/plugin-discovery/search" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
--get \
--data-urlencode "q=$PLUGIN_QUERY" \
--data-urlencode "availability=all" \
--data-urlencode "limit=5" \
--data-urlencode "cursor=$NEXT_CURSOR"
Continue using has_more and next_cursor. Fewer candidates than limit do not establish completion. capabilities_truncated means one candidate’s capability set is incomplete. capability_ref is the full reference used for description/skill reads and may become invalid after installation version or release digest changes.
Fields |
Type |
Required |
Description |
|---|---|---|---|
|
string |
No |
Query text, up to 128 bytes, without surrounding whitespace. |
|
string |
No |
all (default), installed, or market. |
|
integer |
No |
1–5 candidates per page; default 5. |
|
string |
No |
Previous next_cursor; pass unchanged without parsing or inventing it. |
Successful response¶
{
"code": 0,
"data": {
"candidates": [],
"has_more": false
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
Data returned by this operation. |
|
array |
Resource fields; see Shared objects and states. |
|
boolean |
Whether another page exists. |
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.