---
title: Upload
slug: kELz-upload
docTags: 
createdAt: 2022-01-30T21:55:47.000Z
---

Link Enterprise provides an endpoint to upload files to. This is strictly for uploading files, and if you require metadata to be transferred following up with an update endpoint call is required.

:::ApiMethodV2
```json
{
  "tab": "request",
  "url": "https://localhost:82/scrud/upload",
  "name": "Upload",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [
      {
        "kind": "required",
        "name": "cmsName",
        "type": "string",
        "description": "Name of the content management system configured in Link Enterprise."
      },
      {
        "kind": "optional",
        "name": "location",
        "type": "String",
        "description": "Folder id where Link Enterprise  is uploading the file. (box folder id) else root folder used."
      },
      {
        "kind": "optional",
        "name": "Content-Type",
        "type": "string",
        "description": "multipart/form-data; boundary=(insert boundary)\n\nExample is included in code examples"
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "81EVM7WXdGrYfDwshYJW6",
        "code": "SUCCESS EXAMPLE\n{\n\t\"id\": \"910645979785\",\n\t\"result\": \"success\"\n}\n\nFAILED EXAMPLE\n{\n\t\"id\": null.\n\t\"result\": \"fail\"\n}",
        "language": "200"
      },
      {
        "id": "6U9gw-gSaolDqS3WcFi9t",
        "code": "",
        "language": "500"
      }
    ],
    "selectedLanguageId": "81EVM7WXdGrYfDwshYJW6"
  },
  "examples": {
    "languages": [
      {
        "id": "xY6nLYt-BP3jeEy_-jkb3",
        "code": "EXAMPLE\r\n-------\r\n> POST /scrud/upload HTTP/1.1\r\n> Host: localhost:82\r\n> User-Agent: insomnia/2021.7.2\r\n> Cookie: vertx-web.session=8c1a5313de4babf8825fe2114505da7e\r\n> Content-Type: multipart/form-data; boundary=X-INSOMNIA-BOUNDARY\r\n> location: 154829431337\r\n> cmsName: demoprod\r\n> Authorization: Basic ZG9jdWZsb3c6ZG9jdWZsb3c=\r\n> Accept: */*\r\n> Content-Length: 3693\r\n\r\n| --X-INSOMNIA-BOUNDARY\r\n| Content-Disposition: form-data; name=\"\"; filename=\"gimmal_4C.png\"\r\n| Content-Type: image/png\r\n| �PNG\r\n| \u001a\r\n-------\r\nEXAMPLE",
        "language": "none"
      }
    ],
    "selectedLanguageId": "xY6nLYt-BP3jeEy_-jkb3"
  },
  "description": "Upload a file using HTTP multi part form data. HTTP headers specifying folder id, and the content system named must be specified.",
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  },
  "autoGeneratedAnchorSlug": "upload",
  "legacyHash": "SYWoaQaa1CeAs6I_xHZZn"
}
```
:::