Create a XC connection

QA Environment

https://qa-api.kiolinkapp.com

POST

/v1/xc/requests/{id}/connections

XC Connections

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

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-connection-create

Adds a new connection to an XC request, describing the physical Side A / Side B port configuration (data center, phase, cabinet, rack unit, port, wire, and connectors). When data_center_id and/or wire_id are provided, the phase(s) and connector(s) are validated against that data center's active phases and the wire's supported connectors.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Body Params application/jsonRequired

Examples

ExampleXC Inventory Example (Only with data from Salesforce)

{
    "data_center_id": "6932877039ee3e5829d0a38d",
    "phase_a": "Fase 1",
    "company_a": "NVIDIA",
    "external_opportunity_child_id": "XC/IC-XXXXXX",
    "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,
    "phase_b": "Fase 2",
    "company_b": "Amazon",
    "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",
    "connector_a": "FC",
    "connector_b": "SC"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

ExampleXC Inventory Example (Only with data from Salesforce)

curl --location 'https://qa-api.kiolinkapp.com/v1/xc/requests/xcr_utiAM3Q3wMggY0e8/connections' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data_center_id": "6932877039ee3e5829d0a38d",
    "phase_a": "Fase 1",
    "company_a": "NVIDIA",
    "external_opportunity_child_id": "XC/IC-XXXXXX",
    "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,
    "phase_b": "Fase 2",
    "company_b": "Amazon",
    "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",
    "connector_a": "FC",
    "connector_b": "SC"
}'

Responses

🟢201

application/json

Connection created.

Bodyapplication/json

Example

{
    "id": "xcc_SUTkAsyeYlV7gwiZ",
    "xc_request_id": "xcr_NJVb2g1MBnEezNlr",
    "index": 1,
    "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",
    "external_opportunity_child_folio": null,
    "created_at": "string",
    "updated_at": "string"
}

🟠404

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

Get a XC connection

Update a XC connection