> 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/apis-and-developer.md). # APIs & Developer - [Developer Platform](https://docs.taskade.com/apis-and-developer/developer-home.md): Everything you need to build on Taskade — REST API, MCP Server, SDK, and more. - [Developer Overview](https://docs.taskade.com/apis-and-developer/developer-home/developers.md): Build on Taskade with the REST API, OAuth 2.0 and personal tokens, MCP server, webhooks, and Genesis app generation, agents, and automation. - [Authentication](https://docs.taskade.com/apis-and-developer/authentication.md): How to authenticate with every Taskade developer surface — Personal Access Tokens for scripts and MCP, OAuth 2.0 with PKCE for third-party apps. - [Personal Tokens](https://docs.taskade.com/apis-and-developer/authentication/personal-tokens.md): Generate a Taskade Personal Access Token and authenticate API requests with the Authorization Bearer header. Simpler than full OAuth 2.0. - [REST API v1 Reference](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide.md): Taskade REST API v1 reference — authenticate, then manage workspaces, projects, tasks, agents, folders, and media with full CRUD and copy-paste code examples. - [Overview](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/api.md): Build integrations on the Taskade REST API: manage workspaces, projects, tasks, AI agents, and media via authenticated endpoints with Node, Python, and cURL. - [Workspaces](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/workspaces.md): Workspaces — Taskade REST API v1 reference: GET /workspaces. Parameters, authentication, and response schema. - [Get Workspaces](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/workspaces/get-workspaces.md): Get Workspaces — Taskade REST API v1 reference: GET /workspaces. Parameters, authentication, and response schema. - [Create a Project](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/workspaces/get-projects.md): Create a Project in a Workspace — Taskade REST API v1 reference: POST /workspaces/{workspaceId}/projects. Parameters, authentication, and response schema. - [Get Folders](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/workspaces/get-folders.md): Get Folders — Taskade REST API v1 reference: GET /workspaces/{workspaceId}/folders. Parameters, authentication, and response schema. - [Projects](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects.md): Projects — Taskade REST API v1 reference: GET /projects/{projectId}. Parameters, authentication, and response schema. - [Get Project](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/get-project.md): Get Project — Taskade REST API v1 reference: GET /projects/{projectId}. Parameters, authentication, and response schema. - [Create Project](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/create-project.md): Create Project — Taskade REST API v1 reference: POST /projects. Parameters, authentication, and response schema. - [Complete Project](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/complete-project.md): Complete Project — Taskade REST API v1 reference: POST /projects/{projectId}/complete. Parameters, authentication, and response schema. - [Restore Project](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/restore-project.md): Restore Project — Taskade REST API v1 reference: POST /projects/{projectId}/restore. Parameters, authentication, and response schema. - [Copy Project](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/copy-project.md): Copy Project — Taskade REST API v1 reference: POST /projects/{projectId}/copy. Parameters, authentication, and response schema. - [Create From Template](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/create-from-template.md): Create From Template — Taskade REST API v1 reference: POST /projects/from-template. Parameters, authentication, and response schema. - [Get Project Members](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/get-project-members.md): Get Project Members — Taskade REST API v1 reference: GET /projects/{projectId}/members. Parameters, authentication, and response schema. - [Get Project Fields](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/get-project-fields.md): Get Project Fields — Taskade REST API v1 reference: GET /projects/{projectId}/fields. Parameters, authentication, and response schema. - [Get Project Tasks](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/get-project-tasks.md): Get Project Tasks — Taskade REST API v1 reference: GET /projects/{projectId}/tasks. Parameters, authentication, and response schema. - [Get Project Block](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/get-project-block.md): Get Project Block — Taskade REST API v1 reference: GET /projects/{projectId}/blocks. Parameters, authentication, and response schema. - [Get Share Link](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/get-share-link.md): Get Share Link — Taskade REST API v1 reference: GET /projects/{projectId}/shareLink. Parameters, authentication, and response schema. - [Update Share Link](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/projects/update-share-link.md): Update Share Link — Taskade REST API v1 reference: PUT /projects/{projectId}/shareLink. Parameters, authentication, and response schema. - [Tasks](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks.md): Tasks — Taskade REST API v1 reference: GET /projects/{projectId}/tasks/{taskId}. Parameters, authentication, and response schema. - [Create Task](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/create-task.md): Create Task — Taskade REST API v1 reference: POST /projects/{projectId}/tasks/. Parameters, authentication, and response schema. - [Get Task](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/get-task.md): Get Task — Taskade REST API v1 reference: GET /projects/{projectId}/tasks/{taskId}. Parameters, authentication, and response schema. - [Update Task](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/update-task.md): Update Task — Taskade REST API v1 reference: PUT /projects/{projectId}/tasks/{taskId}. Parameters, authentication, and response schema. - [Move Task](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/move-task.md): Move Task — Taskade REST API v1 reference: PUT /projects/{projectId}/tasks/{taskId}/move. Parameters, authentication, and response schema. - [Complete Task](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/complete-task.md): Complete Task — Taskade REST API v1 reference: POST /projects/{projectId}/tasks/{taskId}/complete. Parameters, authentication, and response schema. - [Uncomplete Task](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/uncomplete-task.md): Uncomplete Task — Taskade REST API v1 reference: POST /projects/{projectId}/tasks/{taskId}/uncomplete. Parameters, authentication, and response schema. - [Delete Task](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/delete-task.md): Delete Task — Taskade REST API v1 reference: DELETE /projects/{projectId}/tasks/{taskId}. Parameters, authentication, and response schema. - [Task Assignees](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/get-task-assignees.md): Task Assignees — Taskade REST API v1 reference: GET /projects/{projectId}/tasks/{taskId}/assignees. Parameters, authentication, and response schema. - [Update Task Assignees](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/update-task-assignees.md): Update Task Assignees — Taskade REST API v1 reference: PUT /projects/{projectId}/tasks/{taskId}/assignees. Parameters, authentication, and response schema. - [Delete Task Assignees](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/delete-task-assignees.md): Delete Task Assignees — Taskade REST API v1 reference: DELETE /projects/{projectId}/tasks/{taskId}/assignees/{assigneeHandle}. Parameters,… - [Get Task Date](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/get-task-date.md): Get Task Date — Taskade REST API v1 reference: GET /projects/{projectId}/tasks/{taskId}/date. Parameters, authentication, and response schema. - [Update Task Date](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/update-task-date.md): Update Task Date — Taskade REST API v1 reference: PUT /projects/{projectId}/tasks/{taskId}/date. Parameters, authentication, and response schema. - [Delete Task Date](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/delete-task-date.md): Delete Task Date — Taskade REST API v1 reference: DELETE /projects/{projectId}/tasks/{taskId}/date. Parameters, authentication, and response schema. - [Get Task Note](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/get-task-note.md): Get Task Note — Taskade REST API v1 reference: GET /projects/{projectId}/tasks/{taskId}/note. Parameters, authentication, and response schema. - [Update Task Note](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/update-task-note.md): Update Task Note — Taskade REST API v1 reference: PUT /projects/{projectId}/tasks/{taskId}/note. Parameters, authentication, and response schema. - [Delete Task Note](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/delete-task-note.md): Delete Task Note — Taskade REST API v1 reference: DELETE /projects/{projectId}/tasks/{taskId}/note. Parameters, authentication, and response schema. - [List Task Fields](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/list-task-fields.md): List Task Fields — Taskade REST API v1 reference: GET /projects/{projectId}/tasks/{taskId}/fields. Parameters, authentication, and response schema. - [Get Task Field](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/get-task-field.md): Get Task Field — Taskade REST API v1 reference: GET /projects/{projectId}/tasks/{taskId}/fields/{fieldId}. Parameters, authentication, and response schema. - [Update Task Field](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/update-task-field.md): Update Task Field — Taskade REST API v1 reference: PUT /projects/{projectId}/tasks/{taskId}/fields/{fieldId}. Parameters, authentication, and response… - [Delete Task Field](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/tasks/delete-task-field.md): Delete Task Field — Taskade REST API v1 reference: DELETE /projects/{projectId}/tasks/{taskId}/fields/{fieldId}. Parameters, authentication, and response… - [Agents](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents.md): Agents — Taskade REST API v1 reference: GET /public-agents/{publicAgentId}. Parameters, authentication, and response schema. - [Look Up Public Agent](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/lookup-public-agent.md): Look Up Public Agent — Taskade REST API v1 reference: GET /public-agents/{publicAgentId}. Parameters, authentication, and response schema. - [Get Agent](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/get-agent.md): Get Agent — Taskade REST API v1 reference: GET /agents/{agentId}. Parameters, authentication, and response schema. - [Delete Agent](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/delete-agent.md): Delete Agent — Taskade REST API v1 reference: DELETE /agents/{agentId}. Parameters, authentication, and response schema. - [Update Agent](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/update-agent.md): Update Agent — Taskade REST API v1 reference: PATCH /agents/{agentId}. Parameters, authentication, and response schema. - [Get Public Agent](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/get-public-agent.md): Get Public Agent — Taskade REST API v1 reference: GET /agents/{agentId}/public-agent. Parameters, authentication, and response schema. - [Update Public Agent](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/update-public-agent.md): Update Public Agent — Taskade REST API v1 reference: PATCH /agents/{agentId}/public-agent. Parameters, authentication, and response schema. - [Update Agent Public Access](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/update-agent-public-access.md): Update Agent Public Access — Taskade REST API v1 reference: PUT /agents/{agentId}/publicAccess. Parameters, authentication, and response schema. - [Add Project to Agent Knowledge](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/add-project-to-agent-knowledge.md): Add Project to Agent Knowledge — Taskade REST API v1 reference: POST /agents/{agentId}/knowledge/project. Parameters, authentication, and response schema. - [Add Media to Agent Knowledge](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/add-media-to-agent-knowledge.md): Add Media to Agent Knowledge — Taskade REST API v1 reference: POST /agents/{agentId}/knowledge/media. Parameters, authentication, and response schema. - [Remove Project from Agent Knowledge](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/remove-project-from-agent-knowledge.md): Remove Project from Agent Knowledge — Taskade REST API v1 reference: DELETE /agents/{agentId}/knowledge/project/{projectId}. Parameters, authentication,… - [Remove Media from Agent Knowledge](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/remove-media-from-agent-knowledge.md): Remove Media from Agent Knowledge — Taskade REST API v1 reference: DELETE /agents/{agentId}/knowledge/media/{mediaId}. Parameters, authentication, and… - [Get Agent Conversations](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/get-agent-convos.md): Get Agent Conversations — Taskade REST API v1 reference: GET /agents/{agentId}/convos/. Parameters, authentication, and response schema. - [Get Agent Conversation](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/get-agent-convo.md): Get Agent Conversation — Taskade REST API v1 reference: GET /agents/{agentId}/convos/{convoId}. Parameters, authentication, and response schema. - [Inbound Webhooks](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/agents/inbound-webhooks.md): Inbound webhooks are a way to allow external services to send data into Taskade - [Folders](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/folders.md): Folders — Taskade REST API v1 reference: GET /folders/{folderId}/projects. Parameters, authentication, and response schema. - [Get Folder Projects](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/folders/get-folder-projects.md): Get Folder Projects — Taskade REST API v1 reference: GET /folders/{folderId}/projects. Parameters, authentication, and response schema. - [Generate Agent in Folder](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/folders/generate-agent-in-folder.md): Generate Agent in Folder — Taskade REST API v1 reference: POST /folders/{folderId}/agent-generate. Parameters, authentication, and response schema. - [Create Agent in Folder](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/folders/create-agent-in-folder.md): Create Agent in Folder — Taskade REST API v1 reference: POST /folders/{folderId}/agents. Parameters, authentication, and response schema. - [Get Folder Agents](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/folders/get-folder-agents.md): Get Folder Agents — Taskade REST API v1 reference: GET /folders/{folderId}/agents. Parameters, authentication, and response schema. - [Get Folder Medias](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/folders/get-folder-medias.md): Get Folder Medias — Taskade REST API v1 reference: GET /folders/{folderId}/medias. Parameters, authentication, and response schema. - [Get Folder Project Templates](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/folders/get-folder-project-templates.md): Get Folder Project Templates — Taskade REST API v1 reference: GET /folders/{folderId}/project-templates. Parameters, authentication, and response schema. - [Media](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/media.md): Media — Taskade REST API v1 reference: GET /medias/{mediaId}. Parameters, authentication, and response schema. - [Get Media](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/media/get-media.md): Get Media — Taskade REST API v1 reference: GET /medias/{mediaId}. Parameters, authentication, and response schema. - [Delete Media](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/media/delete-media.md): Delete Media — Taskade REST API v1 reference: DELETE /medias/{mediaId}. Parameters, authentication, and response schema. - [Download Media](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/media/download-media.md): Download Media — Taskade REST API v1 reference: GET /medias/{mediaId}/download. Parameters, authentication, and response schema. - [Upload Media to Space](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/media/upload-media-to-space.md): Upload Media to Space — Taskade REST API v1 reference: POST /medias/spaces/{spaceId}/upload. Parameters, authentication, and response schema. - [Download Media from Space](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/media/download-media-from-space.md): Download Media from Space — Taskade REST API v1 reference: GET /medias/spaces/{spaceId}/download. Parameters, authentication, and response schema. - [Me](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/me.md): Me — Taskade REST API v1 reference: GET /me/projects. Parameters, authentication, and response schema. - [Projects](https://docs.taskade.com/apis-and-developer/comprehensive-api-guide/me/projects.md): Get all projects of mine - [Action API v2 Reference](https://docs.taskade.com/apis-and-developer/api-v2-reference.md): Reference for the Public API v2 — an action-based (RPC-over-HTTP) API. Every call is a POST to a named operation, with cURL, Python, and TypeScript examples. - [TypeScript SDK (Preview)](https://docs.taskade.com/apis-and-developer/sdk-quickstart.md): The TypeScript SDK for Taskade is in preview. Here's how to call the API today with plain HTTP, and what the generated client will look like. - [SDK Cookbook](https://docs.taskade.com/apis-and-developer/sdk-quickstart/sdk-cookbook.md): Integration patterns for Taskade — agents, automations, projects, bundles, error handling, pagination, and testing. - [Which Taskade MCP do I want?](https://docs.taskade.com/apis-and-developer/mcp-overview.md): Three Taskade MCP surfaces, one decision. Pick the right one by what you want to do. - [Workspace MCP](https://docs.taskade.com/apis-and-developer/workspace-mcp.md): Connect Claude Desktop, Cursor, Claude Code, Windsurf, VS Code, and more to your Taskade workspace content with the @taskade/mcp-server inbound MCP server. - [Run your live app by talking to Claude](https://docs.taskade.com/apis-and-developer/workspace-mcp/run-your-app-with-ai.md): Once your Genesis app is live, run its day-to-day data by talking to Claude — no IDs, no API code. - [Workspace MCP: Advanced](https://docs.taskade.com/apis-and-developer/workspace-mcp/workspace-mcp-advanced.md): Rate limits, multi-client setup, troubleshooting, and security guidance for running the Taskade Workspace MCP server in production. - [Hosted MCP — Genesis App (Beta)](https://docs.taskade.com/apis-and-developer/workspace-mcp/genesis-app-mcp.md): Connect Claude, Cursor, or any MCP client to your Taskade Genesis app's source code via https://www.taskade.com/mcp (OAuth 2.0, Business plan). - [MCP Connectors](https://docs.taskade.com/apis-and-developer/mcp-connectors.md): Connect your Taskade Genesis apps and AI agents to 31+ external services using MCP (Model Context Protocol) — the universal standard for AI tool integration. - [Webhooks](https://docs.taskade.com/apis-and-developer/webhooks.md): Use inbound webhooks to trigger Taskade automations from external services, and outbound HTTP requests to call any API from your workflows. - [Bundles & App Kits](https://docs.taskade.com/apis-and-developer/bundles.md): Export and import complete Taskade Genesis apps and workspaces as portable bundles using the Action API v2. - [Long-Term Memory](https://docs.taskade.com/apis-and-developer/long-term-memory.md): Taskade's Long-Term Memory architecture — memory that lives as real Projects in your workspace, editable, browsable, and API-addressable. - [Autonomous Agents](https://docs.taskade.com/apis-and-developer/autonomous-agents.md): Build agents that run without per-request prompting. Automations, multi-agent orchestration, cross-agent invocation, and Autopilot patterns, unified. --- # 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/apis-and-developer.md?ask=&goal= ``` `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.