List target ingress connections

List ingress connections for a target.

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/ingress-connections

Before you call this API

Prepare a personal access token with access to the target workspace and the required action privileges. The path workspace must match X-Workspace-ID. Examples use jq. See Common information for variables, objects, and states.

Query parameters

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/ingress-connections" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "target_kind=agent" \
  --data-urlencode "target_workspace_id=$AGENT_WORKSPACE_ID" \
  --data-urlencode "target_id=$AGENT_ID"

Supply all three target parameters together. This operation is not paginated; total equals the number of items returned. Do not apply the limit/offset template from other resource lists.

Fields

Type

Required

Description

target_kind

string

Yes

agent or team.

target_workspace_id

string

Yes

Workspace that owns the target.

target_id

string

Yes

Target ID.

Successful response

{
  "code": 0,
  "data": {
    "items": [],
    "total": 0
  }
}

Field

Type

Description

code

integer

0 on success.

data

object

Result object; see common object descriptions for fields.

Error response

Handle HTTP status, business results, and error fields as described in Errors and environments. Read current state on source or version conflicts; do not automatically retry with a different identity, resource, or request ID.

Last updated on