Delete an external user

QA Environment

https://qa-api.kiolinkapp.com

DELETE

/v1/kiolink/external-user/{id}

External Users

Last modified:2026-10-05 21:09:53

Maintainer:Not configured

Required Permission(s):staff-external-delete

Permanently deletes an external user. Their visit invitations keep the dangling ID.

An ID that does not exist results in HTTP 500.

Requires a session token whose role has the staff-external-delete permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'https://qa-api.kiolinkapp.com/v1/kiolink/external-user/65f1c2a9e4b0a1b2c3d4e5f1' \
--header 'authorization: <api-key>'

Responses

🟢200The deleted user

application/json

The deleted user.

Bodyapplication/json

Example

{
    "_id": "65f1c2a9e4b0a1b2c3d4e5f1",
    "email": "carlos.ruiz@proveedor.com",
    "name": "Carlos Ruiz",
    "cel": "5512345678",
    "company": "Proveedor SA de CV",
    "avatar": "",
    "devices": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4e603",
            "brand": "Dell",
            "model": "Latitude 7440",
            "series": "CN0ABC123"
        }
    ],
    "created_at": "2025-04-02T17:30:00.000Z",
    "verify_email": "deliverable",
    "__v": 0
}

🟠401The session token expired

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

🔴500Unexpected error (e

Modified at 2026-10-05 21:09:53

Delete an external user's avatar

Send App Notification