Customer Documents Endpoint

Endpoint POST /api/v1/customers/{id}/documents

Change Type ⚠️ Breaking Change

🔄 Summary of Change

We are updating the request payload structure for uploading customer documents.

The files array will no longer be the primary required wrapper for document uploads. Instead, document fields will be accepted at the root level, with optional backward compatibility support for files during the transition period.

🧾 Previous Request Format (Deprecated)

{
  "files": [
    {
      "fileName": "asd",
      "fileBlob": "asdasd",
      "fileType": "ShareholdersRegistry"
    }
  ]
}

✅ New Request Format (Effective from 2nd March 2026)

{
  "fileName": "asd",
  "fileBlob": "asdasd",
  "fileType": "ShareholdersRegistry"
}

🔁 Temporary Backward Compatibility (Transition Phase)

During the migration window, the API will also accept requests containing both root-level fields and the legacy files array. If both are present:

• Root-level fields will take precedence
• files will be ignored

{
  "fileName": "asd",
  "fileBlob": "asdasd",
  "fileType": "ShareholdersRegistry",

  "files": [ // Deprecated by 2nd March 2026
    {
      "fileName": "asd",
      "fileBlob": "asdasd",
      "fileType": "ShareholdersRegistry"
    }
  ]
}