Update a business's status and datacenters

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/business/update-location-status/{id}

Business Locations

Last modified:2026-10-05 20:35:36

Maintainer:Not configured

Required Permission(s):business-status-update

Sets whether a business is active and replaces its datacenters.

Every datacenter and phase must exist in the Datacenter event type.

The business users' datacenter access is trimmed to the new datacenters and phases, and copies their status.

KIO users whose extradata has email_alert: business_status (and a deliverable email) are emailed the new status.

Status and datacenter changes are recorded in the business log.

Requires a session token whose role has the business-status-update permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
  "businessStatus": 1,
  "locationStatus": [
    {
      "datacenter": "MEX1",
      "status": true,
      "fases": [
        "F1",
        "F2"
      ]
    },
    {
      "datacenter": "MEX2",
      "status": false,
      "fases": [
        "F1"
      ]
    }
  ]
}

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/business/update-location-status/65f1c2a9e4b0a1b2c3d4e5a1' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "businessStatus": 1,
  "locationStatus": [
    {
      "datacenter": "MEX1",
      "status": true,
      "fases": [
        "F1",
        "F2"
      ]
    },
    {
      "datacenter": "MEX2",
      "status": false,
      "fases": [
        "F1"
      ]
    }
  ]
}'

Responses

🟢200Status updated

application/json

Status updated.

Bodyapplication/json

Example

{
    "message": "Status updated"
}

🟠400A field is missing, the business does not exist, or a datace

🟠401The session token expired

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

🔴500Unexpected error

Modified at 2026-10-05 20:35:36

Overview

Migrate business locations to datacenters