Tasks | Taskade API

Taskade API

Taskade Changelog Documentation

get

Get task with id

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

get

curl -L \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}'

200

4XX

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

Task

delete

Delete a task in a project

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

delete

curl -L \
  --request DELETE \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}'

200

4XX

{
  "ok": true
}

Successful Task deletion

post

Complete a task in a project

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

post

curl -L \
  --request POST \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/complete'

200

4XX

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

Successful complete a Task

post

Mark a task as incomplete in a project

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

post

curl -L \
  --request POST \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/uncomplete'

200

4XX

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

Successful mark the Task as incomplete

get

Get the assignees of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

get

curl -L \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees'

200

4XX

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

Task assignees

delete

Remove assignee from a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

assigneeHandlestringrequired

Responses

application/json

delete

curl -L \
  --request DELETE \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}'

200

4XX

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

Successful Task Assignment deletion

get

Get the date of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

get

curl -L \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date'

200

4XX

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

Task Date

delete

Delete date of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

delete

curl -L \
  --request DELETE \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date'

200

4XX

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

Successful Task Date deletion

get

Get the note of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

get

curl -L \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note'

200

4XX

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

Task Note

delete

Delete the note of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Responses

application/json

delete

curl -L \
  --request DELETE \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note'

200

4XX

{
  "ok": true
}

Successful Task Note deletion

get

Get the field value of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

fieldIdstringrequired

Responses

application/json

get

curl -L \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}'

200

4XX

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

Task field value

delete

Delete the field value of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

fieldIdstringrequired

Responses

application/json

delete

curl -L \
  --request DELETE \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}'

200

4XX

{
  "ok": true
}

Successful field value deletion

put

Update task.

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Body

contentTypestring · enumrequiredAvailable options:

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

Responses

application/json

put

curl -L \
  --request PUT \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}' \
  --header 'Content-Type: application/json' \
  --data '{
    "contentType": "text/markdown",
    "content": "text"
  }'

200

4XX

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

Updated task

post

Create a task in a project

Authorizations

Path parameters

projectIdstringrequired

Body

tasksall of[] · max: 20required

Responses

application/json

post

curl -L \
  --request POST \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/' \
  --header 'Content-Type: application/json' \
  --data '{
    "tasks": [
      {
        "contentType": "text/markdown",
        "content": "text",
        "taskId": "null",
        "placement": "afterbegin"
      }
    ]
  }'

200

4XX

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

Successful Tasks creation

put

Move a task within the project

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Body

targetobjectrequired

Responses

application/json

put

curl -L \
  --request PUT \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/move' \
  --header 'Content-Type: application/json' \
  --data '{
    "target": {
      "taskId": "text",
      "position": "beforebegin"
    }
  }'

200

4XX

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

Successful move Task

put

Task assignment

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Body

handlesstring[]required

Responses

application/json

put

curl -L \
  --request PUT \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/assignees' \
  --header 'Content-Type: application/json' \
  --data '{
    "handles": [
      "text"
    ]
  }'

200

4XX

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

Successful Task assignment

put

Create or update date for a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Body

startobjectrequired

endobjectoptional

Responses

application/json

put

curl -L \
  --request PUT \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/date' \
  --header 'Content-Type: application/json' \
  --data '{
    "start": {
      "date": "text",
      "time": "text",
      "timezone": "text"
    },
    "end": {
      "date": "text",
      "time": "text",
      "timezone": "text"
    }
  }'

200

4XX

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

Successful Task Date create or update

put

Add/update a note to the task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

Body

typestring · enumrequiredAvailable options:

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

Responses

application/json

put

curl -L \
  --request PUT \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/note' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "text/plain",
    "value": "text"
  }'

200

4XX

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

Successful Task Note creation/update

put

Update/create the field value of a task

Authorizations

Path parameters

projectIdstringrequired

taskIdstringrequired

fieldIdstringrequired

Body

valueany ofrequired

Responses

application/json

put

curl -L \
  --request PUT \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/tasks/{taskId}/fields/{fieldId}' \
  --header 'Content-Type: application/json' \
  --data '{
    "value": 1
  }'

200

4XX

{
  "ok": true
}

Successful field value create/update

Summary of Endpoints

Get Task

Delete Task

Update Task

Complete Task

Uncomplete Task

Create Task

Move Task

Get Task Assignees

Update Task Assignees

Delete Task Assignee

Get Task Date

Delete Task Date

Update Task Date

Get Task Note

Update Task Note

Delete Task Note

Get Task Field

Delete Task Field

Update Task Field

Summary of Endpoints

Get Task

Delete Task

Update Task

Complete Task

Uncomplete Task

Create Task

Move Task

Get Task Assignees

Update Task Assignees

Delete Task Assignee

Get Task Date

Delete Task Date

Update Task Date

Get Task Note

Update Task Note

Delete Task Note

Get Task Field

Delete Task Field

Update Task Field

Show all of

Show child attributes

Show child attributes

Show child attributes

Show child attributes

Show child attributes