Upload or link a file to a partner customer

POST

/partner/v1/customers/{customerId}/files

Request

Path Params

Header Params

Body Params

application/json

Required

Example

{
    "fileAssetId": "ff609797-f24d-4a85-b1cd-e0fde45821c2",
    "purpose": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/partner/v1/customers//files' \
--header 'X-Partner-Client-Id;' \
--header 'X-Partner-Timestamp;' \
--header 'X-Partner-Nonce;' \
--header 'X-Partner-Signature;' \
--header 'X-Request-Id;' \
--header 'Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "fileAssetId": "ff609797-f24d-4a85-b1cd-e0fde45821c2",
    "purpose": "string"
}'

Responses

🟢201Created

application/json

File linked to customer.

Bodyapplication/json

Example

{
    "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
    "fileAssetId": "ff609797-f24d-4a85-b1cd-e0fde45821c2",
    "purpose": "string",
    "originalFilename": "string",
    "contentType": "string",
    "sizeBytes": 0,
    "scanStatus": "string"
}

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Modified at 2026-06-28 00:04:35

Create partner customer

Submit partner-attested KYC or KYB evidence