Request a device status change

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/my-business/status/devices

My Business Devices

Last modified:2026-10-05 22:28:03

Maintainer:Not configured

Required Permission(s):mybusiness-devices-update

Requests KIO to validate the devices sent (e.g. to bring them into the datacenter): each one goes to En validacion and gets a historical_request entry. Devices whose type has automatic_auth are approved immediately (Ingresado, with an automatic movement).

KIO warehouse users (kiolink-profile-almacen) of the devices' locations are notified by email and app notification.

The devices are not checked against the caller's business: they are updated by _id.

Acts on the signed-in business user and their business. KIO users get HTTP 500.

Requires a session token whose role has the mybusiness-devices-update permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Body Params application/jsonRequired

Example

[
  {
    "_id": "65f1c2a9e4b0a1b2c3d4e5d1",
    "_devicetype": {
      "_id": "65f1c2a9e4b0a1b2c3d4e5d9",
      "name": "Servidor"
    },
    "serie": "SGH123ABC",
    "marca": "HPE",
    "modelo": "ProLiant DL380 Gen10",
    "location": "MEX1",
    "fase": "F1",
    "status": "Ingresado",
    "active": true,
    "details": {
      "rack_gabinete": "R12"
    },
    "_business": "65f1c2a9e4b0a1b2c3d4e5a1",
    "movement_request": false,
    "historical": [],
    "historical_request": [],
    "created_at": "2025-01-15T18:00:00.000Z",
    "owner": "Cliente",
    "transfer_request": false,
    "__v": 0
  }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://qa-api.kiolinkapp.com/v1/my-business/status/devices' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '[
  {
    "_id": "65f1c2a9e4b0a1b2c3d4e5d1",
    "_devicetype": {
      "_id": "65f1c2a9e4b0a1b2c3d4e5d9",
      "name": "Servidor"
    },
    "serie": "SGH123ABC",
    "marca": "HPE",
    "modelo": "ProLiant DL380 Gen10",
    "location": "MEX1",
    "fase": "F1",
    "status": "Ingresado",
    "active": true,
    "details": {
      "rack_gabinete": "R12"
    },
    "_business": "65f1c2a9e4b0a1b2c3d4e5a1",
    "movement_request": false,
    "historical": [],
    "historical_request": [],
    "created_at": "2025-01-15T18:00:00.000Z",
    "owner": "Cliente",
    "transfer_request": false,
    "__v": 0
  }
]'

Responses

🟢200The updated devices

application/json

The updated devices.

Bodyapplication/json

Example

[
    {
        "_id": "65f1c2a9e4b0a1b2c3d4e5d1",
        "_devicetype": "65f1c2a9e4b0a1b2c3d4e5d9",
        "serie": "SGH123ABC",
        "marca": "HPE",
        "modelo": "ProLiant DL380 Gen10",
        "location": "MEX1",
        "fase": "F1",
        "status": "En validacion",
        "active": true,
        "details": {
            "rack_gabinete": "R12"
        },
        "_business": "65f1c2a9e4b0a1b2c3d4e5a1",
        "movement_request": false,
        "historical": [],
        "historical_request": [
            {
                "_id": "65f1c2a9e4b0a1b2c3d4e5d3",
                "date": "2026-10-05T18:00:00.000Z",
                "_business_user_request": "65f1c2a9e4b0a1b2c3d4e5f6"
            }
        ],
        "created_at": "2025-01-15T18:00:00.000Z",
        "owner": "Cliente",
        "transfer_request": false,
        "__v": 0
    }
]

🟠401The session token expired

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

🔴500Unexpected error (e

Modified at 2026-10-05 22:28:03

Delete devices of my business

List my business's racks in a location