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

code

integer

0 on success.

data

object

Data returned by this operation.

data.id

string

Resource fields; see Shared objects and states.

data.workspace_id

string

Resource fields; see Shared objects and states.

data.name

string

Resource fields; see Shared objects and states.

data.description

string

Resource fields; see Shared objects and states.

data.status

string

Current state; interpret using this page’s conditions and common objects.

data.kind

string

Resource fields; see Shared objects and states.

data.endpoint_uri

string

Resource fields; see Shared objects and states.

data.auth_type

string

Resource fields; see Shared objects and states.

data.visibility

string

Resource fields; see Shared objects and states.

data.version

integer

Current resource version; used as expected_version for writes.

data.created_at

string

Resource fields; see Shared objects and states.

data.updated_at

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.

Last updated on