Get an ingress connection¶
Read ingress connection details.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/ingress-connections/{connection_id}
Before you call this API¶
Prepare a personal access token with access to the target workspace and permission for the action. The path workspace must match X-Workspace-ID. Examples use jq. See common information for variables, objects, and states.
Request example¶
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/ingress-connections/$CONNECTION_ID" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID"
Get the connection ID from creation or the target list. desired_state is the requested state; observed_state is the receiver’s observed state. connected alone does not establish message and reply delivery.
This action accepts no request body.
Successful response¶
{
"code": 0,
"data": {
"id": "ingress_example",
"workspace_id": "workspace_example",
"target": {
"kind": "agent",
"workspace_id": "workspace_example",
"id": "agent_example"
},
"provider": "slack",
"channel_type": "slack_app",
"receive_mode": "managed_stream",
"agent_model": "model_example",
"association_version": 1,
"connected_by_user_id": "user_example",
"enabled": true,
"account_identity": "slack:app:app_example",
"config_version": 1,
"desired_state": "enabled",
"observed_state": "starting",
"created_at": "2026-11-11T00:00:00Z",
"updated_at": "2026-11-11T00:00:00Z"
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
Result object; see common objects for fields. |
Error responses¶
Handle the HTTP status, business result, and error fields as described in errors and environments. On source or version conflicts, read the current state. Do not automatically replace identities, resources, or request IDs and retry.