Upload a XC document

QA Environment

https://qa-api.kiolinkapp.com

POST

/v1/xc/requests/{id}/documents

XC Documents

Last modified:2026-09-25 00:34:23

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-document-createxc-delivery-receipt-create

Uploads a file and attaches it to an XC request as a document. The file is stored in S3; document_type and the file are required. Optionally scopes the document to a specific connection via xc_connection_id.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

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

Path Params

Body Params multipart/form-dataRequired

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/xcr_HfS91NpO4hlFOKTL/documents' \
--header 'authorization: <api-key>' \
--form 'file=@"C:\\Users\\Guido\\Downloads\\Documento_prueba.pdf"' \
--form 'document_type="SOW"' \
--form 'xc_connection_id=""'

Responses

🟢201

application/json

Document uploaded.

Bodyapplication/json

Example

{
    "id": "xcd_5wtWgLufm9bz2Z2x",
    "xc_request_id": "xcr_IDdyW7BUIcvfokp4",
    "xc_connection_id": null,
    "document_type": "SOW",
    "storage_url": "uploads/event_files/xc/XC-2025-000006/SOW_1764992773752_XC-2025-000006_KIOLink_-_Portal_XC_RFC.pdf",
    "file_name": "KIOLink - Portal XC_RFC.pdf",
    "mime_type": "application/pdf",
    "file_size_bytes": 1459493,
    "uploaded_by_user_id": "6924a8df0f890e30be312081",
    "docusign_envelope_id": null,
    "uploaded_at": "2025-12-06T03:46:14.000Z"
}

🟠404

Modified at 2026-09-25 00:34:23

Get a XC document binary file

Delete a XC document