MCP Gateway
ApiUser connections

Get connection health summary

Return an aggregated health summary of all connections for the authenticated user. Connections are scoped to the current API key owner. Useful for dashboards and alerting.

GET
/api/v1/connections/health

Authorization

User API Key
AuthorizationBearer <token>

User API key (mgw_usr_live_* or mgw_usr_test_*)

In: header

access_token?|

Response Body

application/json

application/json

curl -X GET "https://loading/api/v1/connections/health"
{
  "total_connections": 0,
  "healthy": 0,
  "warning": 0,
  "critical": 0,
  "require_reauth": 0,
  "connections": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "server_id": "820efca4-4a15-4ab7-82fc-9e76f6d61325",
      "server_name": "string",
      "is_valid": true,
      "expires_at": "2019-08-24T14:15:22Z",
      "expires_in_seconds": 0,
      "health_status": "healthy",
      "requires_reauth": false,
      "last_refreshed_at": "2019-08-24T14:15:22Z",
      "next_refresh_at": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}