Delete devices of my business

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/my-business/delete/devices

My Business Devices

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

Maintainer:Not configured

Required Permission(s):mybusiness-devices-delete

Soft-deletes the devices of the signed-in business user's business whose IDs are sent (active: false) and records each deletion. IDs of other businesses are ignored.

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-delete permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Body Params application/jsonRequired

Example

[
  "65f1c2a9e4b0a1b2c3d4e5d1"
]

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/delete/devices' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '[
  "65f1c2a9e4b0a1b2c3d4e5d1"
]'

Responses

🟢200The deleted devices

application/json

The deleted devices.

Bodyapplication/json

Example

{
    "data": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4e5d1",
            "_devicetype": "65f1c2a9e4b0a1b2c3d4e5d9",
            "serie": "SGH123ABC",
            "marca": "HPE",
            "modelo": "ProLiant DL380 Gen10",
            "location": "MEX1",
            "fase": "F1",
            "status": "Ingresado",
            "active": false,
            "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
        }
    ]
}

🟠400The body is not a non-empty array

🟠401The session token expired

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

🔴500Unexpected error

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

Update a device

Request a device status change