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

q

string

No

Query text, up to 128 bytes, without surrounding whitespace.

availability

string

No

all (default), installed, or market.

limit

integer

No

1–5 candidates per page; default 5.

cursor

string

No

Previous next_cursor; pass unchanged without parsing or inventing it.

Successful response

{
  "code": 0,
  "data": {
    "candidates": [],
    "has_more": false
  }
}

Field

Type

Description

code

integer

0 on success.

data

object

Data returned by this operation.

data.candidates

array

Resource fields; see Shared objects and states.

data.has_more

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.

Last updated on