Get plugin account connection details¶
Read nonsensitive configuration and the current version of a plugin account connection.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/plugin-connections/{connection_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 connection_id in the path and also set X-Workspace-ID. See Common objects and inputs for environment-variable sources.
Path parameters¶
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/plugin-connections/$CONNECTION_ID" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID"
Set $CONNECTION_ID to the ID returned by the connection list or creation response in the same workspace. version is the metadata version, not the authorization generation.
This operation does not accept a request body.
Successful response¶
{
"code": 0,
"data": {
"id": "connection_example",
"workspace_id": "workspace_example",
"name": "provider · connection_example",
"description": "我的插件账号",
"status": "active",
"kind": "plugin",
"endpoint_uri": "https://service.example.invalid",
"auth_type": "oauth2",
"visibility": "private",
"version": 1,
"created_at": "2026-11-11T00:00:00Z",
"updated_at": "2026-11-11T00:00:00Z"
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
Data returned by this operation. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Current state; interpret using this page’s conditions and common objects. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Resource fields; see Shared objects and states. |
|
integer |
Current resource version; used as expected_version for writes. |
|
string |
Resource fields; see Shared objects and states. |
|
string |
Resource fields; see Shared objects and states. |
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.