Update a pre-visit

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/kiolink/preevents/{id}

Pre-Visits

Last modified:2026-10-06 00:01:57

Maintainer:Not configured

Required Permission(s):kiolink-preevent-update

Replaces a pre-visit's data with the body. Edits by business users send it back to Pendiente (clearing its pre-authorization) and clear its rejections; the participants are notified. Fields not in the model are stored too.

Edits by KIO users do not change anything (no update is built for them).

Requires a session token whose role has the kiolink-preevent-update permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
  "type": "datacenter",
  "name_event": "Mantenimiento de servidores",
  "sede": "MEX1",
  "sala": "F1",
  "start_date": "2026-10-06T15:00:00.000Z",
  "end_date": "2026-10-06T19:00:00.000Z",
  "descripcion": "Cambio de discos en rack R12",
  "business_users_invitations": [
    {
      "_business_user": "65f1c2a9e4b0a1b2c3d4e5f6"
    }
  ],
  "users_invitations": [],
  "external_invitations": [],
  "device_requests": {
    "ingreso": [],
    "salida": []
  }
}

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/kiolink/preevents/65f1c2a9e4b0a1b2c3d4eb11' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "type": "datacenter",
  "name_event": "Mantenimiento de servidores",
  "sede": "MEX1",
  "sala": "F1",
  "start_date": "2026-10-06T15:00:00.000Z",
  "end_date": "2026-10-06T19:00:00.000Z",
  "descripcion": "Cambio de discos en rack R12",
  "business_users_invitations": [
    {
      "_business_user": "65f1c2a9e4b0a1b2c3d4e5f6"
    }
  ],
  "users_invitations": [],
  "external_invitations": [],
  "device_requests": {
    "ingreso": [],
    "salida": []
  }
}'

Responses

🟢200The updated pre-visit

application/json

The updated pre-visit.

Bodyapplication/json

Example

{
    "_id": "65f1c2a9e4b0a1b2c3d4eb11",
    "folio": "MEX1-00045",
    "type": "datacenter",
    "name_event": "Mantenimiento de servidores",
    "_business_user": "65f1c2a9e4b0a1b2c3d4e5f6",
    "descripcion": "Cambio de discos en rack R12",
    "sede": "MEX1",
    "sala": "F1",
    "device_manage": false,
    "start_date": "2026-10-06T15:00:00.000Z",
    "end_date": "2026-10-06T19:00:00.000Z",
    "status": "Pendiente",
    "created_at": "2026-10-01T17:00:00.000Z",
    "extra_auth": {
        "_coordsecurity_user": {
            "_user": "65f1c2a9e4b0a1b2c3d4e5e7",
            "date": "2026-10-02T10:00:00.000Z"
        }
    },
    "device_requests": {
        "_id": "65f1c2a9e4b0a1b2c3d4eb05",
        "ingreso": [],
        "salida": [],
        "no_registrado": false
    },
    "users_invitations": [],
    "business_users_invitations": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4eb02",
            "_business_user": "65f1c2a9e4b0a1b2c3d4e5f6",
            "response": false,
            "entry": [],
            "devices": []
        }
    ],
    "external_invitations": [],
    "last_update": [],
    "rejection": [],
    "files": [],
    "comments": [],
    "racks": [],
    "kio_apertura": false,
    "business": "65f1c2a9e4b0a1b2c3d4e5a1",
    "covid": false,
    "edit_request": 0,
    "business_name": "Digital Ignition",
    "__v": 0,
    "isPreEvent": true
}

🟠401The session token expired

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

🟠404The pre-visit does not exist

🔴500Unexpected error

Modified at 2026-10-06 00:01:57

Cancel a pre-visit

Overview