KIO Link
KIO Link XC APIKIO Link API
KIO BMSHuawei BMSHuawei Alert
KIO Link XC APIKIO Link API
KIO BMSHuawei BMSHuawei Alert
  1. Businesses
  • Auth
    • Overview
    • Log in
    • Send a one-time sign-in token
    • Log in with Apple
    • Validate a session token
    • Sign in with a one-time sign-in token
    • Request a password reset
    • Get the user of a password reset token
    • Reset a password
    • Submit a business registration request
    • Enable two-factor authentication
    • Confirm a two-factor login
  • Application Content
    • List application content
    • Create application content
    • Get application content by slug
    • Get application content by public id
    • Partially update application content
    • Delete application content
  • Businesses
    • Overview
    • Business Users
      • Overview
      • List business users by business
      • List a business's users
      • Create a business user
      • Get a business user
      • Update a business user
      • Upload a business user's avatar
      • Delete a business user's avatar
      • Deactivate business users
      • Search business users
      • Search a business's users
      • Send a password reset email to a business user
      • Reset a business user's daily sign-in code limits
      • Toggle a business user's two-factor authentication
      • Import business users from CSV
      • Export all business users
      • Set whether I receive releases
      • Set whether I receive alerts
      • Request the deletion of my account
    • Business Roles
      • Overview
      • List business user roles
      • Create a business user role
      • Get a business user role
      • Update a business user role
      • Delete a business user role
    • Business Permissions
      • Overview
      • List business user permissions
      • Create a business user permission
      • Delete a business user permission
    • Business Consoles
      • Overview
      • List a business's consoles
      • Create a business console
      • Delete a business console
    • Business Devices
      • Overview
      • List a business's devices
      • Search a business's devices
      • Export all business devices
      • Export my business's devices
      • Import business devices from CSV
      • Start device transfers from CSV
      • Import device statuses from CSV
      • Delete business devices
      • Change a device's owner
      • Get a business's device transfer log
    • Business Racks
      • Overview
      • Export all business racks
      • Assign a rack to a business
      • List a business's racks
      • List all business racks
      • Change a business rack's status
      • Delete business racks
      • Restore a deleted business rack
      • Import business racks from CSV
    • Business Locations
      • Overview
      • Update a business's status and datacenters
      • Migrate business locations to datacenters
      • Remove the old locations field from businesses
      • Migrate business user locations to datacenters
      • Migrate business device locations to datacenter names
    • Business Reports
      • Overview
      • Send the visits reports
      • Download a visits report
      • Set a business's report recipients
    • List businesses
      GET
    • Search businesses
      GET
    • Search businesses by name or extra data
      GET
    • Export businesses
      GET
    • Get a business
      GET
    • Create a business
      POST
    • Import businesses from CSV
      POST
    • Update a business
      PATCH
    • Delete a business
      DELETE
  • Banned Devices
    • List banned devices
    • Check if a device is risky or banned
    • Get a banned device
    • Create a banned device
    • Update a banned device
    • Delete a banned device
  • Data Centers
    • Listar data centers
    • Crear un data center
    • Actualizar un data center
    • Eliminar un data center
  • Intake Forms
    • List intake form reponses
    • Get an intake form's response
    • Get an intake form's response license file
    • Get an intake form's response identification file
    • Download intake form responses report
    • Create an intake form's response
    • Upload a license file to an intake form's response
    • Upload an identification file to an intake form's response
    • Update an intake form's response
    • Delete an intake form's response
  • Users
    • Overview
    • Permissions
      • Overview
      • Generate KIO user permissions
      • Generate business user permissions
      • List KIO user permissions
      • Create a KIO user permission
      • Delete a KIO user permission
    • Roles
      • Overview
      • List KIO user roles
      • Create a KIO user role
      • Get a KIO user role
      • Update a KIO user role
      • Delete a KIO user role
    • User Groups
      • Overview
      • List user groups
      • Create a user group
      • Update a user group
      • Delete a user group
    • List KIO users
    • Create a KIO user
    • Get a KIO user
    • Update a KIO user
    • Activate or deactivate a KIO user
    • Delete a KIO user
    • Generate a session token for a user
    • Export KIO users
    • Search active KIO users by name
    • Search KIO users
    • Look up an employee in SuccessFactors
    • Import KIO user updates from CSV
  • External Users
    • Overview
    • List external users
    • Find external users to invite
    • Search external users
    • Export external users
    • Create an external user
    • Edit an external user
    • Update an external user
    • Upload an external user's avatar
    • Delete an external user's avatar
    • Delete an external user
  • Send App Notification
    POST
  • Events Locations
    GET
  • Fetch Wires
    GET
  • Create Business Temporary Secret
    POST
  • Schemas
    • Auth
      • Auth Session
      • Two-Factor Status
      • Two-Factor Challenge
      • KIO User Session
    • Businesses
      • Business Users
        • Business User Role
        • Datacenter Access
        • Business User
        • Business User With Relations
        • Business User Permission
      • Business Devices
        • Business Device
        • Business Device Log Entry
      • Business Racks
        • Business Rack
        • Datacenter Rack
      • Business
      • Datacenter Assignment
      • Business List Item
      • Business Console
    • Users
      • User Role
      • User
      • User Permission
      • User Group
      • Permission Catalog
      • SuccessFactors Employee
    • External Users
      • External User
    • ApplicationContentCreate
    • ApplicationContentUpdate
    • ApplicationContent
    • ApplicationContentListResponse
    • Banned Device
    • Error
    • LanguageEntry
    • Pagination
    • Intake Form
    • DataCenter
    • LocalizedContent
    • Delete Result
    • Import Row Error
    • Bulk Write Result
    • Message
    • Personal Device
  1. Businesses

Update a business

QA Environment
https://qa-api.kiolinkapp.com
QA Environment
https://qa-api.kiolinkapp.com
PATCH
https://qa-api.kiolinkapp.com
/v1/business/{id}
Businesses
Last modified:2026-10-05 20:35:27
Maintainer:Not configured
Required Permission(s):business-business-update
Updates a business with the fields sent. admin, _report_business_user and _report_kio_user are ignored; when name changes, normalized_name is updated too.
Side effects:
The business users' datacenter access is trimmed to the business's datacenters and phases.
Changes to traffic_light and preauthorization are recorded in the business log.
KIO users with the business-status-trafficlight permission are emailed whenever the request's traffic_light differs from the stored one. Because a request without traffic_light also differs, they are emailed (with color "Rojo") on every update that omits it.
An ID that does not exist results in HTTP 500.
Requires a session token whose role has the business-business-update permission.

Request

Authorization
API Key
Add parameter in header
authorization
Example:
authorization: ********************
or
Path Params

Body Params application/jsonRequired

Example
{
  "traffic_light": true,
  "preauthorization": false,
  "datacenters": [
    {
      "datacenter": "MEX1",
      "status": true,
      "fases": [
        "F1"
      ]
    }
  ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://qa-api.kiolinkapp.com/v1/business/65f1c2a9e4b0a1b2c3d4e5a1' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "traffic_light": true,
  "preauthorization": false,
  "datacenters": [
    {
      "datacenter": "MEX1",
      "status": true,
      "fases": [
        "F1"
      ]
    }
  ]
}'

Responses

🟢200The updated business
application/json
The updated business.
Bodyapplication/json

Example
{
    "_id": "65f1c2a9e4b0a1b2c3d4e5a1",
    "name": "Digital Ignition",
    "normalized_name": "digital ignition",
    "calle": "Av. Prolongación Paseo de la Reforma 5287",
    "colonia": "Cuajimalpa",
    "municipio": "Cuajimalpa de Morelos",
    "estado": "Ciudad de México",
    "pais": "México",
    "cp": "05000",
    "tel": "5550000000",
    "id_salesforce": "0015e00000AbCdEAAV",
    "admin": "65f1c2a9e4b0a1b2c3d4e5f6",
    "active": 1,
    "traffic_light": true,
    "extradata": [
        {
            "clave": "num_sap",
            "valor": "100234"
        }
    ],
    "datacenters": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4e601",
            "datacenter": "MEX1",
            "status": true,
            "fases": [
                "F1",
                "F2"
            ]
        }
    ],
    "created_at": "2024-03-13T18:22:01.000Z",
    "ejecutivo_finanzas": "finanzas@kio.tech",
    "ejecutivo_finanzas_backup": "",
    "ejecutivo_almacen": "almacen@kio.tech",
    "preauthorization": false,
    "_report_business_user": [
        "65f1c2a9e4b0a1b2c3d4e5f6"
    ],
    "_report_kio_user": [],
    "language_report": "es",
    "frequency_report": "1-month",
    "business_channel": false,
    "business_main": null,
    "qrform": false,
    "has_drwp": false,
    "is_kio_business": false,
    "is_xc_active": true,
    "is_ic_active": false,
    "__v": 0
}
🟠401The session token expired
🟠403Not authenticated (missing/invalid token, inactive user), or
🔴500Unexpected error (e
Modified at 2026-10-05 20:35:27
Previous
Import businesses from CSV
Next
Delete a business
Built with