Get my monitored servers

Returns the servers that CA UIM (Nimsoft) monitors for the user's business, with their alarms and SLAs.

consoles: the user's Nimsoft consoles, each with consoledata: the domains, hubs and robots (servers) discovered for it.

alarms, computer_systems and sla: Nimsoft responses, filtered to items whose origin (or SLA name) is one of the user's consoles.

Works on the monitoring consoles assigned to the signed-in business user (business consoles of type nimsoft; business admins get every console of their business). KIO users get HTTP 500.

Errors of the external system are reported with HTTP 200 and an error body (e.g. Error retriving information.).

Requires a session token whose role has any of these permissions: mykio-nimsoft-os, mykio-nimsoft-alerts, mykio-nimsoft-details.

Responses

🟢200Servers, alarms and SLAs

application/json

Servers, alarms and SLAs. External errors are also reported with this status, with an error body.

Bodyapplication/json

Examples

SuccessExternal error

{
    "consoles": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4e5c1",
            "type": "nimsoft",
            "data": {
                "name": "DIGITALIGNITION"
            },
            "business": "65f1c2a9e4b0a1b2c3d4e5a1",
            "created_at": "2025-02-01T10:00:00.000Z",
            "__v": 0,
            "consoledata": [
                {
                    "domain": "KIO_DOMAIN",
                    "_console": "65f1c2a9e4b0a1b2c3d4ea10",
                    "hubs": {
                        "KIO-HUB-MEX1": [
                            "srv-app-01"
                        ]
                    }
                }
            ]
        }
    ],
    "alarms": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4ea01",
            "slug": "uim.kio.tech-443-/rest/alarms",
            "data": {
                "alarm": [
                    {
                        "origin": [
                            "DIGITALIGNITION"
                        ],
                        "severity": "major",
                        "message": "CPU usage above 90%"
                    }
                ]
            },
            "created": "2026-10-05T18:00:00.000Z",
            "expireAt": "2026-10-05T19:00:00.000Z",
            "__v": 0
        }
    ],
    "sla": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4ea01",
            "slug": "uim.kio.tech-443-/rest/sla/definitions",
            "data": {
                "sla": [
                    {
                        "name": "Server Availability DIGITALIGNITION"
                    }
                ]
            },
            "created": "2026-10-05T18:00:00.000Z",
            "expireAt": "2026-10-05T19:00:00.000Z",
            "__v": 0
        }
    ],
    "computer_systems": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4ea01",
            "slug": "uim.kio.tech-443-/rest/computer_systems",
            "data": {
                "computer_system": [
                    {
                        "name": "srv-app-01",
                        "origin": [
                            "DIGITALIGNITION"
                        ]
                    }
                ]
            },
            "created": "2026-10-05T18:00:00.000Z",
            "expireAt": "2026-10-05T19:00:00.000Z",
            "__v": 0
        }
    ]
}

🟠401The session token expired

🟠403Not authenticated (missing/invalid token, inactive user), or

🔴500Unexpected error

Get my monitored servers

Request

Request Code Samples

Responses