# Upload files

The /items/upload endpoint is used to upload documents containing source data for a new item. 
: , , , , , 


Endpoint: POST /v3/items/upload
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key

  - `Content-type` (string)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise

## Request fields (application/form-data-upload):

  - `files` (array)

## Response 200 fields (application/json):

  - `id` (string)
    Unique ID of the document identified by MeasureOne

  - `uri` (string)
    URI scheme for a remote document. The supported schemes include the M1 scheme, an internal scheme used to refer to internal MeasureOne resources. See below for examples. Supported Schemes are , , , , .Format scheme:[//authority]path[?query][#fragment]

  - `file_name` (string)
    File name of uploaded document

  - `created_at` (number)
    Timestamp at which the document was uploaded

## Response 400 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

  - `http_code` (number)
    Example: 405

## Response 415 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655226381409

  - `error_code` (string)
    MeasureOne Error code
    Example: "UNSUPPORTED_MEDIA_TYPE"

  - `error_message` (string)
    Details of the error
    Example: "Exceed Max File size of 10MB"

  - `http_code` (number)
    http response code
    Example: 415

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error