Tasks

Summary of Endpoints

Get Task

get

Get task with id

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Task

application/json

4XX

Error description

application/json

get

/projects/{projectId}/tasks/{taskId}

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/tasks/{taskId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Successful Task deletion

application/json

4XX

Error description

application/json

delete

/projects/{projectId}/tasks/{taskId}

HTTPcURLJavaScriptPython

DELETE /api/v1/projects/{projectId}/tasks/{taskId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Update Task

put

Update task.

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Body

application/json

contentTypestring · enumRequiredPossible values:

contentstring · max: 2000RequiredPattern: ^[^\r\n]*$

Responses

200

Updated task

application/json

4XX

Error description

application/json

put

/projects/{projectId}/tasks/{taskId}

HTTPcURLJavaScriptPython

PUT /api/v1/projects/{projectId}/tasks/{taskId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Successful complete a Task

application/json

4XX

Error description

application/json

post

/projects/{projectId}/tasks/{taskId}/complete

HTTPcURLJavaScriptPython

POST /api/v1/projects/{projectId}/tasks/{taskId}/complete HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Successful mark the Task as incomplete

application/json

4XX

Error description

application/json

post

/projects/{projectId}/tasks/{taskId}/uncomplete

HTTPcURLJavaScriptPython

POST /api/v1/projects/{projectId}/tasks/{taskId}/uncomplete HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Body

application/json

Responses

200

Successful Tasks creation

application/json

4XX

Error description

application/json

post

/projects/{projectId}/tasks/

HTTPcURLJavaScriptPython

POST /api/v1/projects/{projectId}/tasks/ HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Body

application/json

Responses

200

Successful move Task

application/json

4XX

Error description

application/json

put

/projects/{projectId}/tasks/{taskId}/move

HTTPcURLJavaScriptPython

PUT /api/v1/projects/{projectId}/tasks/{taskId}/move HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Task assignees

application/json

4XX

Error description

application/json

get

/projects/{projectId}/tasks/{taskId}/assignees

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/tasks/{taskId}/assignees HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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

Update Task Assignees

put

Task assignment

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Body

application/json

handlesstring[]Required

Responses

200

Successful Task assignment

application/json

4XX

Error description

application/json

put

/projects/{projectId}/tasks/{taskId}/assignees

HTTPcURLJavaScriptPython

PUT /api/v1/projects/{projectId}/tasks/{taskId}/assignees HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

assigneeHandlestringRequired

Responses

200

Successful Task Assignment deletion

application/json

4XX

Error description

application/json

delete

/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}

HTTPcURLJavaScriptPython

DELETE /api/v1/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Task Date

application/json

4XX

Error description

application/json

get

/projects/{projectId}/tasks/{taskId}/date

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/tasks/{taskId}/date HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Successful Task Date deletion

application/json

4XX

Error description

application/json

delete

/projects/{projectId}/tasks/{taskId}/date

HTTPcURLJavaScriptPython

DELETE /api/v1/projects/{projectId}/tasks/{taskId}/date HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Body

application/json

Responses

200

Successful Task Date create or update

application/json

4XX

Error description

application/json

put

/projects/{projectId}/tasks/{taskId}/date

HTTPcURLJavaScriptPython

PUT /api/v1/projects/{projectId}/tasks/{taskId}/date HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Task Note

application/json

4XX

Error description

application/json

get

/projects/{projectId}/tasks/{taskId}/note

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/tasks/{taskId}/note HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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

Update Task Note

put

Add/update a note to the task

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Body

application/json

typestring · enumRequiredPossible values:

valuestring · min: 1RequiredPattern: ^[^\r\n]*$

Responses

200

Successful Task Note creation/update

application/json

4XX

Error description

application/json

put

/projects/{projectId}/tasks/{taskId}/note

HTTPcURLJavaScriptPython

PUT /api/v1/projects/{projectId}/tasks/{taskId}/note HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

Responses

200

Successful Task Note deletion

application/json

4XX

Error description

application/json

delete

/projects/{projectId}/tasks/{taskId}/note

HTTPcURLJavaScriptPython

DELETE /api/v1/projects/{projectId}/tasks/{taskId}/note HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Get Task Field

get

Get the field value of a task

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

fieldIdstringRequired

Responses

200

Task field value

application/json

4XX

Error description

application/json

get

/projects/{projectId}/tasks/{taskId}/fields/{fieldId}

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "item": {
    "fieldId": "text",
    "value": null
  }
}

Delete Task Field

delete

Delete the field value of a task

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

fieldIdstringRequired

Responses

200

Successful field value deletion

application/json

4XX

Error description

application/json

delete

/projects/{projectId}/tasks/{taskId}/fields/{fieldId}

HTTPcURLJavaScriptPython

DELETE /api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true
}

Update Task Field

put

Update/create the field value of a task

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

taskIdstringRequired

fieldIdstringRequired

Body

application/json

valueany ofRequired

numberOptional

or

string · min: 1Optional

Responses

200

Successful field value create/update

application/json

4XX

Error description

application/json

put

/projects/{projectId}/tasks/{taskId}/fields/{fieldId}

HTTPcURLJavaScriptPython

PUT /api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 11

{
  "value": 1
}

{
  "ok": true
}