Upsert a XC request draft

QA Environment

https://qa-api.kiolinkapp.com

PUT

/v1/xc/requests/draft

XC Requests

Last modified:2026-09-26 20:02:03

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-request-create

Creates a new draft (if id is omitted, returns 201) or updates an existing draft (if id is provided and belongs to a draft, returns 200). Drafts have relaxed validation — requester.name/requester.email may be blank — and no status is set until the request is finalized. Returns 404 if id is provided but doesn't match an existing draft.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Body Params application/jsonRequired

Example

{
    "id": "string",
    "contract_term_months": 12,
    "priority": null,
    "business_id": null,
    "external_opportunity_parent_id": "Op-12345",
    "external_opportunity_parent_optional_id": "Op-Mother-Optional-456",
    "external_opportunity_parent_number": null,
    "external_opportunity_parent_optional_number": null,
    "requester": {
        "name": "string",
        "email": "string"
    },
    "initial_status_code": "string",
    "connections": [
        {
            "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 PUT 'https://qa-api.kiolinkapp.com/v1/xc/requests/draft' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "id": "string",
    "contract_term_months": 12,
    "priority": null,
    "business_id": null,
    "external_opportunity_parent_id": "Op-12345",
    "external_opportunity_parent_optional_id": "Op-Mother-Optional-456",
    "external_opportunity_parent_number": null,
    "external_opportunity_parent_optional_number": null,
    "requester": {
        "name": "string",
        "email": "string"
    },
    "initial_status_code": "string",
    "connections": [
        {
            "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

Draft created or updated.

Bodyapplication/json

Example

{
    "id": "xcr_BpnCIvoscr3ULQs9",
    "type": "XC",
    "code": "XC-2025-000123",
    "requester_name": "David Guido R",
    "requester_email": "david.guido@digitalignition.com.mx",
    "contract_term_months": 12,
    "current_status_id": "xcs_ymSlwDM25wvJ3Msu",
    "kanban_position": null,
    "priority": null,
    "is_draft": false,
    "created_by_user_id": "69ab25325434ff2b1622fa6d",
    "business_id": null,
    "assigned_xc_lead_user_id": null,
    "assigned_implementation_group_id": null,
    "external_opportunity_parent_id": "Op-12345",
    "external_opportunity_parent_optional_id": "Op-Mother-Optional-456",
    "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": "2026-03-23T23:24:44.000Z",
    "updated_at": "2026-03-23T23:24:44.000Z"
}

🟠400

Modified at 2026-09-26 20:02:03

Create a XC request

Update a XC request's general data