> For the complete documentation index, see [llms.txt](https://docs.taskade.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taskade.com/developers/comprehensive-api-guide/projects.md).

# 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 ›**](https://www.taskade.com/learn/agents/knowledge)

## Summary of Endpoints

### Get Project

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Complete Project

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/complete" method="post" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Restore Project

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/restore" method="post" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Copy Project

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/copy" method="post" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Create Project

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects" method="post" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Create From Template

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/from-template" method="post" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Project Members

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/members" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Project Fields

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/fields" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Share Link

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/shareLink" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Update Share Link

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/shareLink" method="put" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Project Blocks

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/blocks" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Project Tasks

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks" method="get" expanded="true" %}
[api-0.1.0.json](https://884954080-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEOkDZjClZ0y8qSYnc7hO%2Fuploads%2Fgit-blob-9c5a76176f5c8981e6384d387b40d33e01dedddc%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.taskade.com/developers/comprehensive-api-guide/projects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.