Get a server's CPU, memory and disk usage for a time window

Returns CPU usage (QOS_CPU_USAGE), physical memory usage (QOS_MEMORY_PHYSICAL_PERC) and the usage of each disk (QOS_DISK_USAGE_PERC) of one of the user's servers, from CA UIM (Nimsoft), for the given time window.

hub and robot must belong to one of the user's consoles; console_id itself is not checked against them, so any Nimsoft console can be queried when the hub and robot names match.

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-details.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Usage history

application/json

Usage history.

Bodyapplication/json

Examples

SuccessExternal error

{
    "cpu": {
        "data": [
            [
                {
                    "_id": "65f1c2a9e4b0a1b2c3d4ea01",
                    "slug": "uim.kio.tech-443-/rest/alarms",
                    "data": {
                        "data": [
                            {
                                "time": "2026-10-05T17:55:00Z",
                                "value": 23.1
                            }
                        ]
                    },
                    "created": "2026-10-05T18:00:00.000Z",
                    "expireAt": "2026-10-05T19:00:00.000Z",
                    "__v": 0
                }
            ]
        ]
    },
    "memory": {
        "data": [
            [
                {
                    "_id": "65f1c2a9e4b0a1b2c3d4ea01",
                    "slug": "uim.kio.tech-443-/rest/alarms",
                    "data": {
                        "data": [
                            {
                                "time": "2026-10-05T17:55:00Z",
                                "value": 48.7
                            }
                        ]
                    },
                    "created": "2026-10-05T18:00:00.000Z",
                    "expireAt": "2026-10-05T19:00:00.000Z",
                    "__v": 0
                }
            ]
        ]
    },
    "disk": {
        "data": [
            {
                "label": "C:\\",
                "values": [
                    {
                        "time": "2026-10-05T17:55:00Z",
                        "value": 61.4
                    }
                ]
            }
        ]
    }
}

🟠401The session token expired

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

🔴500Unexpected error