Projects

The Knowledge Layer is the foundation of every intelligent app you build in Taskade. This is the structured memory that your AI Agents use to understand context, make decisions, and provide insightful responses. This layer is powered by Taskade Projects.

A Project is a flexible, powerful resource that can be used as:

• A structured database for a CRM or a directory.

• A content repository for a knowledge base or documentation site.

• A task list for a project management system.

• A queue for processing data in an automation workflow.

Task Add-ons – Every project node can be enriched with optional add-ons including attachments, assignments, timers / due-dates, reactions & comments, custom fields, and AI pills for context-aware suggestions. These add-ons travel with the node and are fully accessible via the Tasks API.

These endpoints allow you to create, read, update, and delete the Projects that form the Knowledge Layer of your applications.

Learn More

• Agent Knowledge & Memory ›

Summary of Endpoints

Get Project

get

Get project

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Responses

200

Project

application/json

4XX

Error description

application/json

get

/projects/{projectId}

HTTPcURLJavaScriptPython

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

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

Complete Project

post

Mark the project as completed

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Responses

200

Completed project

application/json

4XX

Error description

application/json

post

/projects/{projectId}/complete

HTTPcURLJavaScriptPython

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

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

Restore Project

post

Restore project

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Responses

200

Restored project

application/json

4XX

Error description

application/json

post

/projects/{projectId}/restore

HTTPcURLJavaScriptPython

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

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

Copy Project

post

Copy a project to a folder

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Body

application/json

folderIdstring · min: 1Required

projectTitlestring · min: 1Optional

Responses

200

Successful Project Copied

application/json

4XX

Error description

application/json

post

/projects/{projectId}/copy

HTTPcURLJavaScriptPython

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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

folderIdstring · min: 1Required

contentTypestring · enumRequiredPossible values:

contentstringRequired

Responses

200

Successful Project creation

application/json

4XX

Error description

application/json

post

/projects

HTTPcURLJavaScriptPython

POST /api/v1/projects HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

folderIdstring · min: 1Required

templateIdstring · min: 1Required

Responses

200

Successful Project creation from template

application/json

4XX

Error description

application/json

post

/projects/from-template

HTTPcURLJavaScriptPython

POST /api/v1/projects/from-template HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_SECRET_TOKEN
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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Query parameters

limitnumberOptionalDefault: 20

pagenumberOptionalDefault: 1

Responses

200

Project members.

application/json

4XX

Error description

application/json

get

/projects/{projectId}/members

HTTPcURLJavaScriptPython

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

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

Get Project Fields

get

Get all fields for a project

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Responses

200

Project fields

application/json

4XX

Error description

application/json

get

/projects/{projectId}/fields

HTTPcURLJavaScriptPython

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

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

Get Share Link

get

Get share link for the project

Authorizations

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Responses

200

Share link

application/json

4XX

Error description

application/json

get

/projects/{projectId}/shareLink

HTTPcURLJavaScriptPython

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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

projectIdstringRequired

Responses

200

Share link successfully created

application/json

4XX

Error description

application/json

put

/projects/{projectId}/shareLink

HTTPcURLJavaScriptPython

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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/projects/{projectId}/blocks

HTTPcURLJavaScriptPython

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

oAuthAuthorizationCode & personalAccessToken

OAuth2authorizationCodeRequired

Authorization URL: Token URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

/projects/{projectId}/tasks

HTTPcURLJavaScriptPython

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

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