TaskadeChangelogDocumentation

Knowledge (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

Summary of Endpoints

Get Project

get

Get project

Authorizations
Path parameters
projectIdstringRequired
Responses
200
Project
application/json
get
GET /api/v1/projects/{projectId} HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Complete Project

post

Mark the project as completed

Authorizations
Path parameters
projectIdstringRequired
Responses
200
Completed project
application/json
post
POST /api/v1/projects/{projectId}/complete HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Restore Project

post

Restore project

Authorizations
Path parameters
projectIdstringRequired
Responses
200
Restored project
application/json
post
POST /api/v1/projects/{projectId}/restore HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Copy Project

post

Copy a project to a folder

Authorizations
Path parameters
projectIdstringRequired
Body
folderIdstring · min: 1Required
projectTitlestring · min: 1Optional
Responses
200
Successful Project Copied
application/json
post
POST /api/v1/projects/{projectId}/copy HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_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
Body
folderIdstring · min: 1Required
contentTypestring · enumRequiredPossible values:
contentstringRequired
Responses
200
Successful Project creation
application/json
post
POST /api/v1/projects HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_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
Body
folderIdstring · min: 1Required
templateIdstring · min: 1Required
Responses
200
Successful Project creation from template
application/json
post
POST /api/v1/projects/from-template HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_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
Path parameters
projectIdstringRequired
Query parameters
limitnumberOptionalDefault: 20
pagenumberOptionalDefault: 1
Responses
200
Project members.
application/json
get
GET /api/v1/projects/{projectId}/members HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Get Project Fields

get

Get all fields for a project

Authorizations
Path parameters
projectIdstringRequired
Responses
200
Project fields
application/json
get
GET /api/v1/projects/{projectId}/fields HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Get Share Link

Get share link for the project

Authorizations
Path parameters
projectIdstringRequired
Responses
200
Share link
application/json
get
GET /api/v1/projects/{projectId}/shareLink HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Update Share Link

Enable share link in the project

Authorizations
Path parameters
projectIdstringRequired
Responses
200
Share link successfully created
application/json
put
PUT /api/v1/projects/{projectId}/shareLink HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_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
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
get
GET /api/v1/projects/{projectId}/blocks HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_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
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
get
GET /api/v1/projects/{projectId}/tasks HTTP/1.1
Host: www.taskade.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

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

Last updated