# Request File Upload

Create a file in the file storage using the url provided. Maximum allowed file size is 300 MiB.

Endpoint: POST /v5/files/upload
Version: 5
Security: apiKey

## Request fields (application/json):

  - `url` (string, required)
    File name to be uploaded to the customer-uploads/ directory.
    Example: "dq-chart.png or requestedDirectory/dq-chart.png"

  - `contentLength` (integer, required)
    Content length of file in bytes. Max file size is 300 MiB.
    Example: 110000

## Response 200 fields (application/json):

  - `status` (object)
    Details about status or error of a service

  - `status.code` (integer)
    RFC 7231 status code for this error.
    Example: "200"

  - `status.technicalKey` (string)
    Technical key describing the status or error
    Example: "OK"

  - `status.details` (array)

  - `status.details.id` (integer, required)
    9-digit code which is uniquely identifying a message
    Example: 200000004

  - `status.details.message` (string, required)
    Human-readable message which may also be presented in user interface.
    Example: "The job came to an end and finished successfully."

  - `status.details.technicalKey` (string)
    Technical key to uniquely identify a message.
    Example: "JOB_FINISHED"

  - `status.details.jsonPath` (string)
    JSONPath as specified by the IETF standard
    Example: "$.businessPartner.names[0].value"

  - `status.details.jsonRecord` (string)
    Object provided in plain JSON format.
    Example: "{ \"key\" : \"value\"}"

  - `status.path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `status.timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2026-06-03T12:58:32Z"

  - `uploadLink` (string)
    Url to file.
    Example: "https://file.cdq.com/customer-uploads/cdlbot/dq-chart.png"

  - `uploadMethod` (string)
    Method of uploading file.
    Example: "PUT"

  - `expiresAt` (string)
    Date of expiration (ISO 8601-compliant).
    Example: "2026-06-03T12:58:32Z"

  - `url` (string)
    Url to file, place where it is stored.
    Example: "customer-uploads/cdlbot/dq-chart.png"

## Response 400 fields (application/json):

  - `status` (object)
    Details about status or error of a service