Projects

Summary of Endpoints

Get Project

get

Get project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Responses

200

Project

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId} HTTP/1.1
Host: www.taskade.com
Accept: */*

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text"
  }
}

Complete Project

post

Mark the project as completed

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Responses

200

Completed project

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/projects/{projectId}/complete HTTP/1.1
Host: www.taskade.com
Accept: */*

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text"
  }
}

Restore Project

post

Restore project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Responses

200

Restored project

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/projects/{projectId}/restore HTTP/1.1
Host: www.taskade.com
Accept: */*

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text"
  }
}

Copy Project

post

Copy a project to a folder

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Body

folderIdstring · min: 1Required

projectTitlestring · min: 1Optional

Responses

200

Successful Project Copied

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/projects/{projectId}/copy HTTP/1.1
Host: www.taskade.com
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "folderId": "text",
  "projectTitle": "text"
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text"
  }
}

Create Project

post

Create a project in a folder

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Body

folderIdstring · min: 1Required

contentTypestring · enumRequiredPossible values:

contentstringRequired

Responses

200

Successful Project creation

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/projects HTTP/1.1
Host: www.taskade.com
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "folderId": "text",
  "contentType": "text/markdown",
  "content": "text"
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text"
  }
}

Create From Template

post

Create a project from a custom template

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Body

folderIdstring · min: 1Required

templateIdstring · min: 1Required

Responses

200

Successful Project creation from template

application/json

4XX

Error description

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/projects/from-template HTTP/1.1
Host: www.taskade.com
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "folderId": "text",
  "templateId": "text"
}

{
  "ok": true,
  "item": {
    "id": "text",
    "name": "text"
  }
}

Get Project Members

get

Get members of a project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Project members.

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/members HTTP/1.1
Host: www.taskade.com
Accept: */*

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

Get Project Fields

get

Get all fields for a project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Responses

200

Project fields

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/fields HTTP/1.1
Host: www.taskade.com
Accept: */*

{
  "ok": true,
  "items": [
    {
      "id": "text",
      "data": {
        "type": "boolean"
      }
    }
  ]
}

Get Share Link

get

Get share link for the project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Responses

200

Share link

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/shareLink HTTP/1.1
Host: www.taskade.com
Accept: */*

{
  "ok": true,
  "item": {
    "checkUrl": "https://example.com",
    "editUrl": "https://example.com",
    "viewUrl": "https://example.com"
  }
}

Update Share Link

put

Enable share link in the project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Responses

200

Share link successfully created

application/json

4XX

Error description

application/json

put

HTTPcURLJavaScriptPython

PUT /api/v1/projects/{projectId}/shareLink HTTP/1.1
Host: www.taskade.com
Accept: */*

{
  "ok": true,
  "item": {
    "checkUrl": "https://example.com",
    "editUrl": "https://example.com",
    "viewUrl": "https://example.com"
  }
}

Get Project Blocks

get

Get all blocks for a project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Query parameters

limitnumberOptionalDefault: 100

afterstring · uuidOptional

Parameter for cursor-based pagination. Specify task ID to get blocks after it. Do not specify both before and after.

beforestring · uuidOptional

Parameter for cursor-based pagination. Specify task ID to get blocks before it. Do not specify both before and after.

Responses

200

Blocks

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/blocks HTTP/1.1
Host: www.taskade.com
Accept: */*

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

Get Project Tasks

get

Get all tasks for a project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringRequired

Query parameters

limitnumberOptionalDefault: 100

afterstring · uuidOptional

Parameter for cursor-based pagination. Specify task ID to get tasks after it. Do not specify both before and after.

beforestring · uuidOptional

Parameter for cursor-based pagination. Specify task ID to get tasks before it. Do not specify both before and after.

Responses

200

Tasks

application/json

4XX

Error description

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/projects/{projectId}/tasks HTTP/1.1
Host: www.taskade.com
Accept: */*

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