Tasks

Summary of Endpoints

Get Task

get

Get task with id

Authorizations
Path parameters
projectIdstringRequired
taskIdstringRequired
Responses
200
Task
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
or
string · min: 1Optional
Responses
200
Successful field value create/update
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