Projects

Summary of Endpoints

Get Project

get

Get project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Responses

application/json

application/json

get

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Project

Complete Project

post

Mark the project as completed

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Responses

application/json

application/json

post

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Completed project

Restore Project

post

Restore project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Responses

application/json

application/json

post

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Restored project

Copy Project

post

Copy a project to a folder

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Body

folderIdstring · min: 1required

projectTitlestring · min: 1optional

Responses

application/json

application/json

post

cURLJavaScriptPythonHTTP

curl -L \
  --request POST \
  --url 'https://www.taskade.com/api/v1/projects/{projectId}/copy' \
  --header 'Content-Type: application/json' \
  --data '{
    "folderId": "text",
    "projectTitle": "text"
  }'

200

4XX

200

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

Successful Project Copied

Create Project

post

Create a project in a folder

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Body

folderIdstring · min: 1required

contentTypestring · enumrequiredAvailable options:

contentstringrequired

Responses

application/json

application/json

post

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Successful Project creation

Create From Template

post

Create a project from a custom template

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Body

folderIdstring · min: 1required

templateIdstring · min: 1required

Responses

application/json

application/json

post

cURLJavaScriptPythonHTTP

curl -L \
  --request POST \
  --url 'https://www.taskade.com/api/v1/projects/from-template' \
  --header 'Content-Type: application/json' \
  --data '{
    "folderId": "text",
    "templateId": "text"
  }'

200

4XX

200

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

Successful Project creation from template

Get Project Members

get

Get members of a project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Query parameters

limitnumberoptionalDefault: 20

pagenumberoptionalDefault: 1

Responses

application/json

application/json

get

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Project members.

Get Project Fields

get

Get all fields for a project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Responses

application/json

application/json

get

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Project fields

Get Share Link

get

Get share link for the project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Responses

application/json

application/json

get

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Share link

Update Share Link

put

Enable share link in the project

Authorizations

oAuthAuthorizationCodepersonalAccessToken

Path parameters

projectIdstringrequired

Responses

application/json

application/json

put

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Share link successfully created

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

application/json

application/json

get

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Blocks

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

application/json

application/json

get

cURLJavaScriptPythonHTTP

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

200

4XX

200

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

Tasks