Deactivate users of my business

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/my-businessusers/users/delete

My Business Users

Last modified:2026-10-05 22:26:58

Maintainer:Not configured

Required Permission(s):mybusiness-users-delete

Deactivates the users of the signed-in business user's business whose IDs are sent (active: false), cancels their upcoming KIO Link events, and records each deactivation. IDs of other businesses are ignored.

Validation errors are returned with HTTP 500 (the handler sets code instead of status).

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

Requires a session token whose role has the mybusiness-users-delete permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Body Params application/jsonRequired

Example

[
  "65f1c2a9e4b0a1b2c3d4e5f7"
]

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

Responses

🟢200The deactivated users

application/json

The deactivated users.

Bodyapplication/json

Example

[
    {
        "_id": "65f1c2a9e4b0a1b2c3d4e5f7",
        "firstname": "Luis",
        "lastname": "Martínez",
        "email": "luis.martinez@example.com",
        "devices": [],
        "device_tokens": [],
        "consoles": [],
        "active": false,
        "role": "65f1c2a9e4b0a1b2c3d4e5b3",
        "business": "65f1c2a9e4b0a1b2c3d4e5a1",
        "created_at": "2025-05-01T18:00:00.000Z",
        "level": "Operador",
        "verify_email": "deliverable",
        "delete_request": false,
        "id_service_desk_plus": "0",
        "two_factor_auth_activated": false,
        "two_factor_auth_unavailable": false,
        "sent_feedback": false,
        "__v": 0
    }
]

🟠401The session token expired

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

🔴500The body is not a non-empty array, or another error happened

Modified at 2026-10-05 22:26:58

Update a user of my business

Send a password reset email to a user of my business