# Upload files

Upload one or multiple files to the system. Supports bulk uploads and various file sources. Files are uploaded via multipart/form-data and can be associated with suppliers, segments, or folders for organization.

Endpoint: POST /v2/files/upload
Version: 2
Security: bearer

## Query parameters:

  - `type` (string, required)
    The type/source of the file being uploaded
    Enum: "businessInformation", "connection", "inquiry"

  - `folder_id` (string)
    Optional folder ID to organize uploaded files
    Example: "507f1f77bcf86cd799439011"

  - `segment_id` (string)
    Optional segment ID to associate files with a specific segment
    Example: "507f1f77bcf86cd799439011"

  - `supplier_id` (string)
    Optional supplier ID to associate files with a specific supplier
    Example: "507f1f77bcf86cd799439011"

  - `display_name` (array)
    Optional custom display name for the uploaded file(s). For multiple files, provide multiple display_name parameters (e.g., display_name=Name1&display_name=Name2). Order must match file order. Note: The number of files with custom display names may be limited by query string length restrictions.

## Request fields (multipart/form-data):

  - `files` (array, required)

## Response 201 fields (application/json):

  - `_id` (string, required)
    The unique identifier of the uploaded file
    Example: "507f1f77bcf86cd799439011"

  - `filename` (string, required)
    The filename of the uploaded file
    Example: "BI_Document_2024.pdf"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields