Update a XC connection

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/xc/connections/{id}

XC Connections

Last modified:2026-09-25 22:10:55

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-connection-update

Updates one or more fields of an existing connection. If data_center_id/wire_id end up set (existing or newly provided), the phase(s) and connector(s) are re-validated against them.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Body Params application/jsonRequired

Example

{
    "business_id": null,
    "contract_term_months": 12,
    "data_center_id": "6932877039ee3e5829d0a38d",
    "linked_data_center_id": null,
    "company_a": "NVIDIA",
    "phase_a": "Fase 1",
    "cabinet_a": "Gabinete A",
    "deliver_on_tip_a": false,
    "rack_unit_a": "Rack A",
    "endpoint_label_a": "Endpoint A",
    "port_a": "Puerto A",
    "allow_alternative_port_a": true,
    "company_b": "Amazon",
    "phase_b": "Fase 2",
    "cabinet_b": "Gabinete B",
    "deliver_on_tip_b": false,
    "rack_unit_b": "Rack B",
    "endpoint_label_b": "Endpoint B",
    "port_b": "Puerto B",
    "allow_alternative_port_b": false,
    "wire_id": "6932877039ee3e5829d0a3b1",
    "wire_name_snapshot": "Fibra Monomodo",
    "connector_a": "FC",
    "connector_b": "SC",
    "comments": null,
    "external_opportunity_child_id": "XC/IC-XXXXXX"
}

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/xc/connections/xcc_SUTkAsyeYlV7gwiZ' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "business_id": null,
    "contract_term_months": 12,
    "data_center_id": "6932877039ee3e5829d0a38d",
    "linked_data_center_id": null,
    "company_a": "NVIDIA",
    "phase_a": "Fase 1",
    "cabinet_a": "Gabinete A",
    "deliver_on_tip_a": false,
    "rack_unit_a": "Rack A",
    "endpoint_label_a": "Endpoint A",
    "port_a": "Puerto A",
    "allow_alternative_port_a": true,
    "company_b": "Amazon",
    "phase_b": "Fase 2",
    "cabinet_b": "Gabinete B",
    "deliver_on_tip_b": false,
    "rack_unit_b": "Rack B",
    "endpoint_label_b": "Endpoint B",
    "port_b": "Puerto B",
    "allow_alternative_port_b": false,
    "wire_id": "6932877039ee3e5829d0a3b1",
    "wire_name_snapshot": "Fibra Monomodo",
    "connector_a": "FC",
    "connector_b": "SC",
    "comments": null,
    "external_opportunity_child_id": "XC/IC-XXXXXX"
}'

Responses

🟢200

application/json

The updated connection.

Bodyapplication/json

Example

{
    "id": "xcc_FoRlvnDasQKZ3cHW",
    "xc_request_id": "xcr_BpnCIvoscr3ULQs9",
    "index": 1,
    "data_center_id": "6932877039ee3e5829d0a38d",
    "company_a": "NVIDIA",
    "external_opportunity_child_id": "XC/IC-XXXXXX",
    "phase_a": "Fase 1",
    "cabinet_a": "Gabinete A",
    "deliver_on_tip_a": false,
    "rack_unit_a": "Rack A",
    "endpoint_label_a": "Endpoint A",
    "port_a": "Puerto A",
    "allow_alternative_port_a": true,
    "company_b": "Amazon",
    "phase_b": "Fase 2",
    "cabinet_b": "Gabinete B",
    "deliver_on_tip_b": false,
    "rack_unit_b": "Rack B",
    "endpoint_label_b": "Endpoint B",
    "port_b": "Puerto B",
    "allow_alternative_port_b": false,
    "wire_id": "6932877039ee3e5829d0a3b7",
    "wire_name_snapshot": "Fibra Óptica Multimodo OM3",
    "connector_a": "LC",
    "connector_b": "SC",
    "created_at": "2025-12-05T07:35:07.000Z",
    "updated_at": "2025-12-05T07:42:52.000Z"
}

🟠404

Modified at 2026-09-25 22:10:55

Create a XC connection

Delete a XC connection