Get visible executor connection states

Returns connection projections for visible Runners and enabled Sandboxes. Failed Astra state reads retain executors with astra_reachable=false. An empty visible set does not probe Astra, so true is not proof of platform-wide real-time health. connected/ready grants no execution privileges; states may be cached for5 seconds.

GET https://api.moi.matrixorigin.cn/v5/agent-executors/health

Before you call this API

BASE_URL uses the product API prefix https://api.moi.matrixorigin.cn/v5. For a dedicated deployment, use its corresponding product API address.

Prepare identity and identifiers.

Request

curl --request GET \
  "$BASE_URL/agent-executors/health" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"

Parameter

Location

Type

Required

Description

X-Workspace-ID

Header

string

Yes

Target workspace in the same environment; no workspace segment in the path.

Successful response

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "executors": [
      {
        "id": "runner-example",
        "name": "示例Runner",
        "type": "runner",
        "phase": "pending",
        "edge_agent_id": "runner-runner-example",
        "connected": false,
        "ready": false
      }
    ],
    "astra_reachable": false
  }
}

Field

Type

Description

code

string

OK on success.

msg

string

Response information; OK on success.

data

object

Response objects and omission rules.

Error response

Errors and recovery boundaries distinguishes Runner, Edge renewal, and compute observations. They do not share one numeric error table.

Last updated on