Tasks
Summary of Endpoints
Get Task
get
Get task with id
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Task
application/json
4XX
Error description
application/json
get
GET /api/v1/projects/{projectId}/tasks/{taskId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Delete Task
delete
Delete a task in a project
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Successful Task deletion
application/json
4XX
Error description
application/json
delete
DELETE /api/v1/projects/{projectId}/tasks/{taskId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true
}
Update Task
put
Update task.
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Body
contentTypestring · enumRequiredPossible values:
contentstring · max: 2000RequiredPattern:
^[^\r\n]*$
Responses
200
Updated task
application/json
4XX
Error description
application/json
put
PUT /api/v1/projects/{projectId}/tasks/{taskId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48
{
"contentType": "text/markdown",
"content": "text"
}
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Complete Task
post
Complete a task in a project
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Successful complete a Task
application/json
4XX
Error description
application/json
post
POST /api/v1/projects/{projectId}/tasks/{taskId}/complete HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Uncomplete Task
post
Mark a task as incomplete in a project
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Successful mark the Task as incomplete
application/json
4XX
Error description
application/json
post
POST /api/v1/projects/{projectId}/tasks/{taskId}/uncomplete HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Create Task
post
Create a task in a project
Authorizations
Path parameters
projectIdstringRequired
Body
Responses
200
Successful Tasks creation
application/json
4XX
Error description
application/json
post
POST /api/v1/projects/{projectId}/tasks/ HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 101
{
"tasks": [
{
"contentType": "text/markdown",
"content": "text",
"taskId": "null",
"placement": "afterbegin"
}
]
}
{
"ok": true,
"item": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
]
}
Move Task
put
Move a task within the project
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Body
Responses
200
Successful move Task
application/json
4XX
Error description
application/json
put
PUT /api/v1/projects/{projectId}/tasks/{taskId}/move HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53
{
"target": {
"taskId": "text",
"position": "beforebegin"
}
}
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Get Task Assignees
get
Get the assignees of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Task assignees
application/json
4XX
Error description
application/json
get
GET /api/v1/projects/{projectId}/tasks/{taskId}/assignees HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"items": [
{
"handle": "text",
"displayName": "text"
}
]
}
Update Task Assignees
put
Task assignment
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Body
handlesstring[]Required
Responses
200
Successful Task assignment
application/json
4XX
Error description
application/json
put
PUT /api/v1/projects/{projectId}/tasks/{taskId}/assignees HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 20
{
"handles": [
"text"
]
}
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Delete Task Assignee
delete
Remove assignee from a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
assigneeHandlestringRequired
Responses
200
Successful Task Assignment deletion
application/json
4XX
Error description
application/json
delete
DELETE /api/v1/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Get Task Date
get
Get the date of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Task Date
application/json
4XX
Error description
application/json
get
GET /api/v1/projects/{projectId}/tasks/{taskId}/date HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"start": {
"date": "text",
"time": "text",
"timezone": "text"
},
"end": {
"date": "text",
"time": "text",
"timezone": "text"
}
}
}
Delete Task Date
delete
Delete date of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Successful Task Date deletion
application/json
4XX
Error description
application/json
delete
DELETE /api/v1/projects/{projectId}/tasks/{taskId}/date HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Update Task Date
put
Create or update date for a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Body
Responses
200
Successful Task Date create or update
application/json
4XX
Error description
application/json
put
PUT /api/v1/projects/{projectId}/tasks/{taskId}/date HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 111
{
"start": {
"date": "text",
"time": "text",
"timezone": "text"
},
"end": {
"date": "text",
"time": "text",
"timezone": "text"
}
}
{
"ok": true,
"item": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"parentId": "123e4567-e89b-12d3-a456-426614174000",
"completed": false
}
}
Get Task Note
get
Get the note of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Task Note
application/json
4XX
Error description
application/json
get
GET /api/v1/projects/{projectId}/tasks/{taskId}/note HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"type": "text",
"value": "text"
}
}
Update Task Note
put
Add/update a note to the task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Body
typestring · enumRequiredPossible values:
valuestring · min: 1RequiredPattern:
^[^\r\n]*$
Responses
200
Successful Task Note creation/update
application/json
4XX
Error description
application/json
put
PUT /api/v1/projects/{projectId}/tasks/{taskId}/note HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"type": "text/plain",
"value": "text"
}
{
"ok": true,
"item": {
"type": "text",
"value": "text"
}
}
Delete Task Note
delete
Delete the note of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Successful Task Note deletion
application/json
4XX
Error description
application/json
delete
DELETE /api/v1/projects/{projectId}/tasks/{taskId}/note HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true
}
Get Task Field
get
Get the field value of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
fieldIdstringRequired
Responses
200
Task field value
application/json
4XX
Error description
application/json
get
GET /api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true,
"item": {
"fieldId": "text",
"value": null
}
}
Delete Task Field
delete
Delete the field value of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
fieldIdstringRequired
Responses
200
Successful field value deletion
application/json
4XX
Error description
application/json
delete
DELETE /api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"ok": true
}
Update Task Field
put
Update/create the field value of a task
Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
fieldIdstringRequired
Body
valueany ofRequired
numberOptional
string · min: 1Optional
Responses
200
Successful field value create/update
application/json
4XX
Error description
application/json
put
PUT /api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 11
{
"value": 1
}
{
"ok": true
}
Last updated