---
title: Tasks
slug: tasks
docTags: 
createdAt: 2022-01-05T09:27:19.000Z
---

Currently Link Enterprise  has an endpoint to create tasks on top of files and assign them to a user (among other things).

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://localhost:82/scrud/createTask",
  "name": "Create Tasks",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "Unique id of box file or folder."
      },
      {
        "kind": "required",
        "name": "type",
        "type": "string",
        "description": "Name of metadata template in box."
      },
      {
        "kind": "required",
        "name": "selectedCMS",
        "type": "string",
        "description": "Value should always be set to \"box\" to let Link Enterprise  know which configured content system to search."
      },
      {
        "kind": "required",
        "name": "body",
        "type": "Array",
        "description": "Json Array of strings (each index being a seperate line). \n\nOr can take a single string value \"singleLineExample\""
      },
      {
        "kind": "required",
        "name": "dueDate",
        "type": "string",
        "description": "Date the task is due\n\n2100-12-31 (YYYY-MM-DD)\n"
      },
      {
        "kind": "required",
        "name": "recipients",
        "type": "Array",
        "description": "Array of strings of recipients of the task (email id)\n\n*User may require permissions to file before being able to be assigned a task."
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "qNYNaQPOhJ1UW-zegaFJ6",
        "code": "",
        "language": "200"
      },
      {
        "id": "FRMYak2F3gPEAHrtkDAvt",
        "code": "",
        "language": "500"
      }
    ],
    "selectedLanguageId": "qNYNaQPOhJ1UW-zegaFJ6"
  },
  "examples": {
    "languages": [
      {
        "id": "npeO0usSroLpgszC5fpHh",
        "code": "{\r\n \"cmsName\":\"insertProductionSystemName (located in Link Enterprise gui)\",\r\n \"id\": \"insert box file id\",\r\n\t\"taskType\":\"insert Task type (described in params)\",\r\n\t\"recipients\":\r\n             [\r\n              \"admin@gimmal.com\",\r\n      \t      \"admin2@gimmal.com\"\r\n             ],\r\n\t\"body\":  [\r\n              \"Hi\",\r\n      \t      \"Thank you.\"\r\n             ],\r\n\t\"dueDate\":\"2021-12-30\", \r\n        \"selectedCMS\":\"box\",\r\n\r\n\r\n}",
        "language": "json"
      },
      {
        "id": "ZhU-IX53oNPcu7rTsSn1n",
        "code": "",
        "language": "none"
      }
    ],
    "selectedLanguageId": "npeO0usSroLpgszC5fpHh"
  },
  "description": "Create a task on a file",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "autoGeneratedAnchorSlug": "create-tasks",
  "legacyHash": "qY7HAGpZETj9t2-9xMoY7"
}
```
:::

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://localhost:82/scrud/createTask",
  "name": "Create Tasks",
  "method": "POST",
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "kind": "required",
        "name": "id",
        "type": "string",
        "description": "Unique id of box file or folder."
      },
      {
        "kind": "required",
        "name": "type",
        "type": "string",
        "description": "Name of metadata template in box."
      },
      {
        "kind": "required",
        "name": "selectedCMS",
        "type": "string",
        "description": "Value should always be set to \"box\" to let Link Enterprise know which configured content system to search."
      },
      {
        "kind": "required",
        "name": "body",
        "type": "Array",
        "description": "Json Array of strings (each index being a seperate line). \n\nOr can take a single string value \"singleLineExample\""
      },
      {
        "kind": "required",
        "name": "dueDate",
        "type": "string",
        "description": "Date the task is due\n\n2100-12-31 (YYYY-MM-DD)\n"
      },
      {
        "kind": "required",
        "name": "recipients",
        "type": "Array",
        "description": "Array of strings of recipients of the task (email id)\n\n*User may require permissions to file before being able to be assigned a task."
      }
    ],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "qNYNaQPOhJ1UW-zegaFJ6",
        "code": "",
        "language": "100"
      },
      {
        "id": "FRMYak2F3gPEAHrtkDAvt",
        "code": "",
        "language": "500"
      }
    ],
    "selectedLanguageId": "qNYNaQPOhJ1UW-zegaFJ6"
  },
  "examples": {
    "languages": [
      {
        "id": "npeO0usSroLpgszC5fpHh",
        "code": "{\r\n \"cmsName\":\"insertProductionSystemName (located in Link Enterprise gui)\",\r\n \"id\": \"insert box file id\",\r\n\t\"taskType\":\"insert Task type (described in params)\",\r\n\t\"recipients\":\r\n             [\r\n              \"admin@gimmal.com\",\r\n      \t      \"admin2@gimmal.com\"\r\n             ],\r\n\t\"body\":  [\r\n              \"Hi\",\r\n      \t      \"Thank you.\"\r\n             ],\r\n\t\"dueDate\":\"2021-12-30\", \r\n        \"selectedCMS\":\"box\",\r\n\r\n\r\n}",
        "language": "json"
      },
      {
        "id": "ZhU-IX53oNPcu7rTsSn1n",
        "code": "",
        "language": "none"
      }
    ],
    "selectedLanguageId": "npeO0usSroLpgszC5fpHh"
  },
  "description": "Create a task on a file",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "autoGeneratedAnchorSlug": "create-tasks-1",
  "legacyHash": "8Ulfr4LyHjkK0bR5Eq25B"
}
```
:::