> 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/tasks.md).

# Tasks

Tasks — Taskade REST API v1 reference: get, create, update, move, complete, and delete tasks, plus assignees, dates, notes, and fields.

{% hint style="info" %}
**Generated reference:** This reference is also at [taskade.com/docs/rest](https://www.taskade.com/docs/rest), generated from the live OpenAPI spec. AI agents can do most of this work through the [hosted Taskade MCP server](https://docs.taskade.com/developers/workspace-mcp/genesis-app-mcp.md).
{% endhint %}

## Summary of Endpoints

### Get Task

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Delete Task

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}" method="delete" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Update Task

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Complete Task

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Uncomplete Task

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/uncomplete" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Create Task

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Move Task

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/move" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Task Assignees

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/assignees" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Update Task Assignees

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/assignees" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Delete Task Assignee

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}" method="delete" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Task Date

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/date" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Delete Task Date

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/date" method="delete" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Update Task Date

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/date" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Task Note

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/note" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Update Task Note

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/note" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Delete Task Note

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/note" method="delete" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### List Task Fields

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Get Task Field

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/fields/{fieldId}" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Delete Task Field Value

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/fields/{fieldId}" method="delete" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}

### Update Task Field

{% openapi src="/files/BofPKQdStkZSorv2iHCa" path="/projects/{projectId}/tasks/{taskId}/fields/{fieldId}" 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-49e40343dfe39109a3f0620b76420f962ebb99c4%2Fapi-0.1.0.json?alt=media)
{% endopenapi %}
