Update a user of my business

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/my-businessusers/{id}

My Business Users

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

Maintainer:Not configured

Required Permission(s):mybusiness-users-update

Updates a user of the signed-in business user's business. The users of the business with the mybusiness-users-notifications permission are notified by email and app notification.

firstname, lastname and email are required. When one is missing, the response is HTTP 200 with a message, but the update still runs with the fields that were sent.

An ID that does not exist in the business results in HTTP 500.

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

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
  "firstname": "Luis",
  "lastname": "Martínez",
  "email": "luis.martinez@example.com",
  "role": "65f1c2a9e4b0a1b2c3d4e5b3",
  "level": "Supervisor"
}

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/65f1c2a9e4b0a1b2c3d4e5f7' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "firstname": "Luis",
  "lastname": "Martínez",
  "email": "luis.martinez@example.com",
  "role": "65f1c2a9e4b0a1b2c3d4e5b3",
  "level": "Supervisor"
}'

Responses

🟢200The updated user

application/json

The updated user. A missing required field is also reported with this status, with a message body.

Bodyapplication/json

Examples

SuccessMissing field

{
    "_id": "65f1c2a9e4b0a1b2c3d4e5f7",
    "firstname": "Luis",
    "lastname": "Martínez",
    "email": "luis.martinez@example.com",
    "devices": [],
    "device_tokens": [],
    "consoles": [],
    "active": true,
    "role": "65f1c2a9e4b0a1b2c3d4e5b3",
    "business": "65f1c2a9e4b0a1b2c3d4e5a1",
    "created_at": "2025-05-01T18:00:00.000Z",
    "level": "Supervisor",
    "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

🔴500Unexpected error (e

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

Get a user of my business

Deactivate users of my business