The Task Relationships API from Clickup — 2 operation(s) for task relationships.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/clickup-task-relationships-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: ClickUp API v2 Reference Task Relationships API
description: The ClickUp API enables you to programmatically access and manage your ClickUp resources.
contact: {}
version: '2.0'
servers:
- url: https://api.clickup.com/api
description: ClickUp
variables: {}
security:
- Authorization_Token: []
tags:
- name: Task Relationships
paths:
/v2/task/{task_id}/dependency:
parameters: []
post:
summary: Add Dependency
tags:
- Task Relationships
description: Set a task as waiting on or blocking another task.
operationId: AddDependency
parameters:
- name: task_id
in: path
description: This is the task which is waiting on or blocking another task.
required: true
style: simple
schema:
type: string
examples:
- 9hv
- name: custom_task_ids
in: query
description: If you want to reference a task by it's custom task id, this value must be `true`.
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: team_id
in: query
description: '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`.'
style: form
explode: true
schema:
type: number
contentEncoding: double
examples:
- 123
requestBody:
description: "Use the `depends_on` parameter in the request body to specify the task that must be completed before the task in the path parameter.\\\n \\\nUse the `dependency_of` parameter in the request body to specify the task that's waiting for the task in the path parameter to be completed.\\\n \\\nYou can only use one per request."
content:
application/json:
schema:
title: AddDependencyrequest
type: object
properties:
depends_on:
type: string
dependency_of:
type: string
examples:
- depends_on: 9hw
example:
depends_on: 9hw
required: true
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
examples:
- {}
contentMediaType: application/json
example: {}
deprecated: false
delete:
summary: Delete Dependency
tags:
- Task Relationships
description: Remove the dependency relationship between two or more tasks.
operationId: DeleteDependency
parameters:
- name: task_id
in: path
description: ''
required: true
style: simple
schema:
type: string
examples:
- 9hv
- name: depends_on
in: query
description: ''
required: true
style: form
explode: true
schema:
type: string
examples:
- 9hz
- name: dependency_of
in: query
description: ''
required: true
style: form
explode: true
schema:
type: string
examples:
- 9hz
- name: custom_task_ids
in: query
description: If you want to reference a task by it's custom task id, this value must be `true`.
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: team_id
in: query
description: "When the `custom_task_ids` parameter is set to `true`, the Workspace ID must be provided using the `team_id` parameter.\n \\\nFor example: `custom_task_ids=true&team_id=123`."
style: form
explode: true
schema:
type: number
contentEncoding: double
examples:
- 123
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
type: object
examples:
- {}
contentMediaType: application/json
example: {}
deprecated: false
/v2/task/{task_id}/link/{links_to}:
parameters: []
post:
summary: Add Task Link
tags:
- Task Relationships
description: 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.
operationId: AddTaskLink
parameters:
- name: task_id
in: path
description: The task to initiate the link from.
required: true
style: simple
schema:
type: string
examples:
- 9hv
- name: links_to
in: path
description: The task to link to.
required: true
style: simple
schema:
type: string
examples:
- 9hz
- name: custom_task_ids
in: query
description: If you want to reference a task by it's custom task id, this value must be `true`.
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: team_id
in: query
description: "When the `custom_task_ids` parameter is set to `true`, the Workspace ID must be provided using the `team_id` parameter.\n \\\nFor example: `custom_task_ids=true&team_id=123`."
style: form
explode: true
schema:
type: number
contentEncoding: double
examples:
- 123
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
title: AddTaskLinkresponse
required:
- task
type: object
properties:
task:
title: Task
required:
- id
- name
- status
- orderindex
- date_created
- date_updated
- date_closed
- creator
- assignees
- checklists
- tags
- parent
- priority
- due_date
- start_date
- time_estimate
- time_spent
- list
- folder
- space
- linked_tasks
- url
type: object
properties:
id:
type: string
name:
type: string
status:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/status'
orderindex:
type: string
date_created:
type: string
date_updated:
type: string
date_closed:
type:
- string
- 'null'
creator:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/creator'
assignees:
type: array
items:
type: string
description: ''
checklists:
type: array
items:
type: string
description: ''
tags:
type: array
items:
type: string
description: ''
parent:
type:
- string
- 'null'
priority:
type:
- string
- 'null'
due_date:
type:
- string
- 'null'
start_date:
type:
- string
- 'null'
time_estimate:
type:
- string
- 'null'
time_spent:
type:
- string
- 'null'
list:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/list'
folder:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/folder'
space:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/space'
linked_tasks:
type: array
items:
title: LinkedTask
required:
- task_id
- link_id
- date_created
- userid
type: object
properties:
task_id:
type: string
link_id:
type: string
date_created:
type: string
userid:
type: string
examples:
- task_id: 9hv
link_id: 9hz
date_created: '1587571108988'
userid: '183'
description: ''
url:
type: string
examples:
- 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
examples:
- 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
example:
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
deprecated: false
delete:
summary: Delete Task Link
tags:
- Task Relationships
description: Remove the link between two tasks.
operationId: DeleteTaskLink
parameters:
- name: task_id
in: path
description: ''
required: true
style: simple
schema:
type: string
examples:
- 9hv
- name: links_to
in: path
description: ''
required: true
style: simple
schema:
type: string
examples:
- 9hz
- name: custom_task_ids
in: query
description: If you want to reference a task by it's custom task id, this value must be `true`.
style: form
explode: true
schema:
type: boolean
examples:
- true
- name: team_id
in: query
description: "When the `custom_task_ids` parameter is set to `true`, the Workspace ID must be provided using the `team_id` parameter.\n \\\nFor example: `custom_task_ids=true&team_id=123`."
style: form
explode: true
schema:
type: number
contentEncoding: double
examples:
- 123
responses:
'200':
description: ''
headers: {}
content:
application/json:
schema:
title: DeleteTaskLinkresponse
required:
- task
type: object
properties:
task:
title: Task1
required:
- id
- name
- status
- orderindex
- date_created
- date_updated
- date_closed
- creator
- assignees
- checklists
- tags
- parent
- priority
- due_date
- start_date
- time_estimate
- time_spent
- list
- folder
- space
- linked_tasks
- url
type: object
properties:
id:
type: string
name:
type: string
status:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/status'
orderindex:
type: string
date_created:
type: string
date_updated:
type: string
date_closed:
type:
- string
- 'null'
creator:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/creator'
assignees:
type: array
items:
type: string
description: ''
checklists:
type: array
items:
type: string
description: ''
tags:
type: array
items:
type: string
description: ''
parent:
type:
- string
- 'null'
priority:
type:
- string
- 'null'
due_date:
type:
- string
- 'null'
start_date:
type:
- string
- 'null'
time_estimate:
type:
- string
- 'null'
time_spent:
type:
- string
- 'null'
list:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/list'
folder:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/folder'
space:
$ref: '#/paths/~1v2~1task~1{task_id}/get/responses/200/content/application~1json/schema/properties/space'
linked_tasks:
type: array
items:
type: string
description: ''
url:
type: string
examples:
- 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: []
url: https://app.clickup.com/t/9hx
examples:
- 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: []
url: https://app.clickup.com/t/9hx
example:
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: []
url: https://app.clickup.com/t/9hx
deprecated: false
components:
securitySchemes:
Authorization_Token:
name: Authorization
type: apiKey
in: header
description: 'API token required for authentication. Two types of tokens are supported:
**Personal API Key** Obtain from ClickUp''s settings page under ''Apps'' and add it to the header as `Authorization: pk_...`
**OAuth2 Access Token** Generated through the OAuth2 flow and add it to the header as `Authorization: Bearer {access_token}`'