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 |
|---|---|---|---|
|
string |
Yes |
agent or team. |
|
string |
Yes |
Workspace that owns the target. |
|
string |
Yes |
Target ID. |
Successful response¶
{
"code": 0,
"data": {
"items": [],
"total": 0
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
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.