Sign in

v1

latestOpenAPI 3.1.02026-07-24172151607.6 KB
Task Relationships

Add Task Link

This is the equivalent of the feature Task Links in the right-hand sidebar of a Task. It allows you to link two tasks together. General links or links to other objects than tasks are not supported.

post/v2/task/{task_id}/link/{links_to}

Path parameters

task_idstring required
Example:9hv

The task to initiate the link from.

links_tostring required
Example:9hz

The task to link to.

Query parameters

custom_task_idsboolean
Example:true

If you want to reference a task by it's custom task id, this value must be true.

team_idnumber
Example:123

When the custom_task_ids parameter is set to true, the Workspace ID must be provided using the team_id parameter.
For example: custom_task_ids=true&team_id=123.

Response

Example response

{
  "task": {
    "id": "9hv",
    "name": "Task Name",
    "status": {
      "status": "in progress",
      "color": "#d3d3d3",
      "orderindex": 1,
      "type": "custom"
    },
    "orderindex": "1.00000000000000000000000000000000",
    "date_created": "1567780450202",
    "date_updated": "1567780450202",
    "date_closed": null,
    "creator": {
      "id": 183,
      "username": "John Doe",
      "color": "#827718",
      "profilePicture": "https://attachments-public.clickup.com/profilePictures/183_abc.jpg"
    },
    "assignees": [],
    "checklists": [],
    "tags": [],
    "parent": null,
    "priority": null,
    "due_date": null,
    "start_date": null,
    "time_estimate": null,
    "time_spent": null,
    "list": {
      "id": "123"
    },
    "folder": {
      "id": "456"
    },
    "space": {
      "id": "789"
    },
    "linked_tasks": [
      {
        "task_id": "9hv",
        "link_id": "9hz",
        "date_created": "1587571108988",
        "userid": "183"
      }
    ],
    "url": "https://app.clickup.com/t/9hx"
  }
}