Change a device's owner

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/business/{businessid}/device/{deviceid}/owner

Business Devices

Last modified:2026-10-05 20:36:34

Maintainer:Not configured

Required Permission(s):business-devices-edit

Sets whether a device belongs to KIO or to the client. Any other field sent is also written to the device.

Requires a session token whose role has the business-devices-edit permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
  "owner": "KIO"
}

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/business/65f1c2a9e4b0a1b2c3d4e5a1/device/65f1c2a9e4b0a1b2c3d4e5d1/owner' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "owner": "KIO"
}'

Responses

🟢200The updated device

application/json

The updated device.

Bodyapplication/json

Example

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

🟠400`owner` is missing or not `KIO`/`Cliente`

🟠401The session token expired

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

🟠404The device does not exist in this business

🔴500Unexpected error

Modified at 2026-10-05 20:36:34

Delete business devices

Get a business's device transfer log