Tasks

Summary of Endpoints

Get Task

Get task with id

GEThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}

Path parameters

projectId*string

taskId*string

Response

2004XX

Task

Body

application/json

ok*boolean

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": false,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Delete Task

Delete a task in a project

DELETEhttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}

Path parameters

projectId*string

taskId*string

Response

2004XX

Successful Task deletion

Body

application/json

ok*enum

true

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": true
}

Update Task

Update task.

PUThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}

Path parameters

projectId*string

taskId*string

Body

application/json

contentType*enum

text/markdowntext/plain

content*string

Pattern: ^[^\r\n]*$

Response

2004XX

Updated task

Body

application/json

ok*boolean

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "contentType": "text/markdown",
      "content": "text"
    }),
});
const data = await response.json();

Response

2004XX

{
  "ok": false,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Complete Task

Complete a task in a project

POSThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/complete

Path parameters

projectId*string

taskId*string

Response

2004XX

Successful complete a Task

Body

application/json

ok*enum

true

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/complete', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Uncomplete Task

Mark a task as incomplete in a project

POSThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/uncomplete

Path parameters

projectId*string

taskId*string

Response

2004XX

Successful mark the Task as incomplete

Body

application/json

ok*enum

true

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/uncomplete', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Create Task

Create a task in a project

POSThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/

Path parameters

projectId*string

Body

application/json

tasks*array of all of

Response

2004XX

Successful Tasks creation

Body

application/json

ok*enum

true

item*array of Task (object)

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "tasks": [
        {
          "contentType": "text/markdown",
          "content": "text",
          "placement": "afterbegin"
        }
      ]
    }),
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "text": "text",
      "parentId": "123e4567-e89b-12d3-a456-426614174000",
      "completed": false
    }
  ]
}

Move Task

Move a task within the project

PUThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/move

Path parameters

projectId*string

taskId*string

Body

application/json

target*object

Response

2004XX

Successful move Task

Body

application/json

ok*enum

true

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/move', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "target": {
        "taskId": "text",
        "position": "beforebegin"
      }
    }),
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Get Task Assignees

Get the assignees of a task

GEThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees

Path parameters

projectId*string

taskId*string

Response

2004XX

Task assignees

Body

application/json

ok*boolean

items*array of User (object)

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": false,
  "items": [
    {
      "handle": "text",
      "displayName": "text"
    }
  ]
}

Update Task Assignees

Task assignment

PUThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees

Path parameters

projectId*string

taskId*string

Body

application/json

handles*array of string

Response

2004XX

Successful Task assignment

Body

application/json

ok*enum

true

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "handles": [
        "text"
      ]
    }),
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Delete Task Assignee

Remove assignee from a task

DELETEhttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}

Path parameters

projectId*string

taskId*string

assigneeHandle*string

Response

2004XX

Successful Task Assignment deletion

Body

application/json

ok*enum

true

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Get Task Date

Get the date of a task

GEThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date

Path parameters

projectId*string

taskId*string

Response

2004XX

Task Date

Body

application/json

ok*enum

true

item*object

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "start": {
      "date": "text",
      "time": "text",
      "timezone": "text"
    },
    "end": {
      "date": "text",
      "time": "text",
      "timezone": "text"
    }
  }
}

Delete Task Date

Delete date of a task

DELETEhttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date

Path parameters

projectId*string

taskId*string

Response

2004XX

Successful Task Date deletion

Body

application/json

ok*enum

true

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Update Task Date

Create or update date for a task

PUThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date

Path parameters

projectId*string

taskId*string

Body

application/json

start*Date (object)

endDate (object)

Response

2004XX

Successful Task Date create or update

Body

application/json

ok*enum

true

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "start": {
        "date": "text"
      }
    }),
});
const data = await response.json();

Response

2004XX

{
  "ok": true,
  "item": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "text": "text",
    "parentId": "123e4567-e89b-12d3-a456-426614174000",
    "completed": false
  }
}

Get Task Note

Get the note of a task

GEThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note

Path parameters

projectId*string

taskId*string

Response

2004XX

Task Note

Body

application/json

ok*boolean

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": false,
  "item": {
    "type": "text",
    "value": "text"
  }
}

Update Task Note

Add/update a note to the task

PUThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note

Path parameters

projectId*string

taskId*string

Body

application/json

type*enum

text/plaintext/markdown

value*string

Pattern: ^[^\r\n]*$

Response

2004XX

Successful Task Note creation/update

Body

application/json

ok*boolean

item*nullable all of

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "type": "text/plain",
      "value": "text"
    }),
});
const data = await response.json();

Response

2004XX

{
  "ok": false,
  "item": {
    "type": "text",
    "value": "text"
  }
}

Delete Task Note

Delete the note of a task

DELETEhttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note

Path parameters

projectId*string

taskId*string

Response

2004XX

Successful Task Note deletion

Body

application/json

ok*boolean

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": false
}

Get Task Field

Get the field value of a task

GEThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}

Path parameters

projectId*string

taskId*string

fieldId*string

Response

2004XX

Task field value

Body

application/json

ok*boolean

item*FieldValue (object)

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": false,
  "item": {
    "fieldId": "text"
  }
}

Delete Task Field

Delete the field value of a task

DELETEhttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}

Path parameters

projectId*string

taskId*string

fieldId*string

Response

2004XX

Successful field value deletion

Body

application/json

ok*boolean

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "ok": false
}

Update Task Field

Update/create the field value of a task

PUThttps://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}

Path parameters

projectId*string

taskId*string

fieldId*string

Body

application/json

value*any of

numberstring

Response

2004XX

Successful field value create/update

Body

application/json

ok*boolean

Request

JavaScriptCurlPython

const response = await fetch('https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "value": 0
    }),
});
const data = await response.json();

Response

2004XX

{
  "ok": false
}