Get a server's ping history

QA Environment

https://qa-api.kiolinkapp.com

GET

/v1/mykio/ping/{console_id}/{hub}/{robot}

MyKIO

Last modified:2026-10-05 23:38:46

Maintainer:Not configured

Required Permission(s):mykio-nimsoft-details

Returns the ping response times (QOS_NET_CONNECT) of one of the user's servers, from CA UIM (Nimsoft), for the last hour.

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

Authorization

API Key

Add parameter in header

authorization

Example:

authorization: ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qa-api.kiolinkapp.com/v1/mykio/ping/65f1c2a9e4b0a1b2c3d4ea10/KIO-HUB-MEX1/srv-app-01' \
--header 'authorization: <api-key>'

Responses

🟢200Ping history

application/json

Ping history.

Bodyapplication/json

Examples

SuccessExternal error

{
    "data": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4ea01",
            "slug": "uim.kio.tech-443-/rest/qos/data/name/QOS_NET_CONNECT/KIO-HUB-MEX1/srv-app-01:ping/lasthour/now/0",
            "data": {
                "data": [
                    {
                        "time": "2026-10-05T17:55:00Z",
                        "value": 1.2
                    }
                ]
            },
            "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

Modified at 2026-10-05 23:38:46

Get a server's probes

Get a server's ping history for a time window