Create a XC request

QA Environment

https://qa-api.kiolinkapp.com

POST

/v1/xc/requests

XC Requests

Last modified:2026-09-26 19:59:09

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-request-create

Creates a new (non-draft) XC request. requester (name + email) is required. The request starts in initial_status_code (defaults to RECIBIDO) and can include an initial batch of connections. Business users have business_id auto-filled from their token; admin/KIO users may set it explicitly.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Body Params application/jsonRequired

Example

{
    "requester": {
        "name": "David Guido R",
        "email": "david.guido@digitalignition.com.mx"
    },
    "contract_term_months": 26,
    "external_opportunity_parent_id": "Op-12345",
    "external_opportunity_parent_optional_id": "Op-Mother-Optional-456",
    "connections": [
        {
            "data_center_id": "69667f3afa6795a8207184fa",
            "phase_a": "Fase 1",
            "company_a": "NVIDIA",
            "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 --location 'https://qa-api.kiolinkapp.com/v1/xc/requests' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requester": {
        "name": "David Guido R",
        "email": "david.guido@digitalignition.com.mx"
    },
    "contract_term_months": 26,
    "external_opportunity_parent_id": "Op-12345",
    "external_opportunity_parent_optional_id": "Op-Mother-Optional-456",
    "connections": [
        {
            "data_center_id": "69667f3afa6795a8207184fa",
            "phase_a": "Fase 1",
            "company_a": "NVIDIA",
            "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

Request created.

Bodyapplication/json

Example

{
    "id": "xcr_BpnCIvoscr3ULQs9",
    "type": "XC",
    "code": "XC-2025-000005",
    "requester_name": "John Wick",
    "requester_email": "john_wick@gmail.com",
    "contract_term_months": 26,
    "current_status_id": "xcs_uKwYYmF2N9p2fmQW",
    "kanban_position": null,
    "priority": null,
    "is_draft": false,
    "created_by_user_id": "6924a8df0f890e30be312081",
    "business_id": null,
    "assigned_xc_lead_user_id": null,
    "assigned_implementation_group_id": null,
    "external_opportunity_parent_id": null,
    "external_opportunity_parent_optional_id": null,
    "external_opportunity_parent_number": null,
    "external_opportunity_parent_optional_number": null,
    "external_case_id": null,
    "external_xc_id": null,
    "sow_generated_at": null,
    "sow_signed_at": null,
    "implementation_started_at": null,
    "implementation_completed_at": null,
    "created_at": "2025-12-05T07:35:07.000Z",
    "updated_at": "2025-12-05T07:35:07.000Z"
}

🟠400

Modified at 2026-09-26 19:59:09

Get a XC request (complete details)

Upsert a XC request draft