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

# Developer Platform

Build on Taskade with REST API v1, Action API v2, OAuth 2.0, signed webhooks, agent embeds, and three MCP connection paths.

Use the Taskade APIs to connect your app to Taskade. You can also build automations or connect AI tools.

For the fastest start, [get a token](#get-a-token). Then [make your first call](#make-your-first-call).

Many teams first build an app visually with [Taskade Genesis](https://www.taskade.com/create). Then they add to the app with the API.

## Before you start

* A Taskade account with a verified email address. Taskade does not create a token for an unverified account.
* `curl` in a terminal, or any HTTP client.
* Basic Taskade concepts: workspaces, projects, and tasks. If you are new to Taskade, start with [Learn Taskade](https://www.taskade.com/learn).

## Integration surface at a glance

**Calls from your app, script, or agent into Taskade:**

* **REST API v1** (RESTful, Bearer auth): projects and tasks, AI agents, media and bundles.
* **Action API v2** (RPC, Bearer auth): projects and tasks, AI agents, media and bundles.
* **`@taskade/mcp-server`** (inbound MCP, from npm): runs on your machine and calls REST API v1.
* **Hosted MCP** at `https://www.taskade.com/mcp`: projects, AI agents, and Taskade Genesis app source. It also lists and runs automations.

**Events from Taskade to your app:**

* **Signed Webhook API**: register a webhook with the API to get events.
* **Automation triggers**: a larger catalog of events, with no code.

**Calls from Taskade to other services:**

* **MCP Client connector**: outbound MCP, as a step inside an automation.

AI agents keep long-term memory. They write this memory to projects in your workspace.

## Choose a surface

| I want to...                                                                                    | Use                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Write tasks, manage assignees/dates/fields (full CRUD)                                          | [REST API v1](https://docs.taskade.com/developers/comprehensive-api-guide.md). The [Action API v2](https://docs.taskade.com/developers/api-v2-reference.md) writes the same data. It has no call that reads one task, or its assignees, date, note, or field value. |
| Prompt agents, register signed webhooks                                                         | [Action API v2](https://docs.taskade.com/developers/api-v2-reference.md)                                                                                                                                                                                            |
| Manage agents, export/import bundles                                                            | Either version                                                                                                                                                                                                                                                      |
| Call endpoints from any language                                                                | [REST API v1](https://docs.taskade.com/developers/comprehensive-api-guide.md) + [Action API v2](https://docs.taskade.com/developers/api-v2-reference.md)                                                                                                            |
| Give Claude Desktop, Cursor, or other MCP clients access to Taskade projects, tasks, and agents | [Hosted Taskade MCP](https://docs.taskade.com/developers/workspace-mcp/genesis-app-mcp.md) or [Workspace MCP](https://docs.taskade.com/developers/workspace-mcp.md)                                                                                                 |
| Call the tools of another MCP server from an automation                                         | [MCP Client connector](https://www.taskade.com/learn/connect/mcp-client-integration)                                                                                                                                                                                |
| Edit Taskade Genesis app source code from your IDE                                              | [Hosted MCP (Taskade Genesis apps)](https://docs.taskade.com/developers/workspace-mcp/genesis-app-mcp.md)                                                                                                                                                           |
| Receive real-time events in your app                                                            | [Webhooks](https://docs.taskade.com/developers/webhooks.md)                                                                                                                                                                                                         |
| Add a public AI agent to your website                                                           | [Agent Embeds](https://docs.taskade.com/developers/agent-embeds.md)                                                                                                                                                                                                 |
| Understand long-term memory                                                                     | [Long-Term Memory](https://docs.taskade.com/developers/long-term-memory.md)                                                                                                                                                                                         |
| Build agents that run without a prompt                                                          | [Autonomous Agents](https://docs.taskade.com/developers/autonomous-agents.md)                                                                                                                                                                                       |
| Build automations without code                                                                  | [Automations Engine](https://www.taskade.com/automate)                                                                                                                                                                                                              |
| Browse App Kits in Taskade App Factory                                                          | [taskade.com/apps](https://www.taskade.com/apps)                                                                                                                                                                                                                    |

## Get a token

Use a **personal access token** for scripts, both APIs, the local MCP server, and hosted MCP clients that set their own headers. Interactive clients can connect to hosted MCP with OAuth 2.0.

1. Go to [taskade.com/settings/api](https://www.taskade.com/settings/api).
2. Go to **Personal access tokens** and click **Create token**.
3. Give the token a name that tells you what it is for.
4. Copy the token. Taskade does not show it again.
5. Save the token in your terminal:

```bash
export TASKADE_TOKEN="tskdp_your_token_here"
```

{% hint style="warning" %}
Keep your API token secret, like a password. Never commit it to version control. Never share it publicly.
{% endhint %}

## Base URLs

Taskade has **two** public HTTP APIs. Both APIs use the same token.

[**REST API v1**](https://docs.taskade.com/developers/comprehensive-api-guide.md) is RESTful (`GET`, `POST`, `PUT`, `DELETE`). Use it for full task CRUD, assignees, dates, notes, and fields.

```
https://www.taskade.com/api/v1
```

[**Action API v2**](https://docs.taskade.com/developers/api-v2-reference.md) is action style (RPC, `POST /{operation}`). Media, bundle downloads, and webhook registration use REST-style endpoints. Use v2 to prompt agents, and to manage agents, bundles, signed webhooks, and tasks (full CRUD).

```
https://www.taskade.com/api/v2
```

{% hint style="info" %}
**Live OpenAPI specs (source of truth)** come from the running API:

* REST API v1 - [interactive docs](https://www.taskade.com/api/documentation/v1) · [openapi.json](https://www.taskade.com/api/documentation/v1/json)
* Action API v2 - [interactive docs](https://www.taskade.com/api/documentation/v2) · [openapi.json](https://www.taskade.com/api/documentation/v2/json)

The `/docs/rest/*` and `/docs/actions/*` catalogs come from committed OpenAPI snapshots.

The Getting Started, Guides, and MCP pages contain hand-written examples and patterns.

For an exact field or status code, use the generated catalog and its source spec.
{% endhint %}

## Make your first call

Each API lists the projects that your account can open. Send the same token to both.

```bash
# REST API v1
curl -s https://www.taskade.com/api/v1/me/projects \
  -H "Authorization: Bearer $TASKADE_TOKEN"

# Action API v2: every operation is a POST with a JSON body
curl -s -X POST https://www.taskade.com/api/v2/listMyProjects \
  -H "Authorization: Bearer $TASKADE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Both calls return `ok: true` and an `items` array. Each item has the project `id` and `name`:

```json
{
  "ok": true,
  "items": [
    { "id": "Pj8sK2nV4wQx6ZbE", "name": "API quickstart" }
  ]
}
```

The v1 item can also have `icon` and `completed`.

## Errors

Both APIs return the same JSON error envelope. The HTTP status matches the `code`. For example, `POST /api/v2/webhooks` on a Free plan returns `402`:

```json
{
  "ok": false,
  "message": "Webhooks require a Pro plan or higher.",
  "code": "PAYMENT_REQUIRED",
  "statusMessage": "Payment Required"
}
```

Branch on `ok` and `code`. Do not parse `message`.

Some `PAYMENT_REQUIRED` errors also have a `featureId` field. It names the plan entitlement that the request needs. For example, a bundle export on a plan without export returns `featureId: "space.bundle.export"`.

| What you see                                              | Cause                                                     | Fix                                                                                                   |
| --------------------------------------------------------- | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `"code": "UNAUTHORIZED"` with `"message": "Unauthorized"` | The token is missing, wrong, or revoked                   | Send `Authorization: Bearer $TASKADE_TOKEN`. Make sure that the variable is set in the same terminal. |
| `"code": "FST_ERR_VALIDATION"`                            | The request body or a parameter does not match the schema | Read `message`. It names each field that failed, then the reason.                                     |
| `"code": "PAYMENT_REQUIRED"`                              | The plan does not include this operation                  | Upgrade the plan, or read `featureId` to see which entitlement is missing.                            |
| `"code": "FORBIDDEN"`                                     | Your account cannot do this in the workspace              | Use an account with the correct role in that workspace.                                               |
| `"code": "NOT_FOUND"`                                     | The ID is wrong, or your account cannot see the item      | Make sure that the ID is correct and that you have access to the workspace.                           |
| `"code": "TOO_MANY_REQUESTS"`                             | You sent too many requests                                | Wait for the number of seconds in the `Retry-After` header, then send the request again.              |

## Developer resources

| Resource                                                                                                | Description                                                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [REST Endpoint Catalog](https://www.taskade.com/docs/rest)                                              | Exact methods, parameters, and response schemas. Taskade generates it from the committed v1 OpenAPI spec                                                                                        |
| [Actions Endpoint Catalog](https://www.taskade.com/docs/actions)                                        | Exact operation bodies and response schemas. Taskade generates it from the committed v2 OpenAPI spec                                                                                            |
| [REST API Guide](https://docs.taskade.com/developers/comprehensive-api-guide.md)                        | REST concepts, examples, and usage patterns, written by hand                                                                                                                                    |
| [Action API Guide](https://docs.taskade.com/developers/api-v2-reference.md)                             | Action (RPC) concepts, examples, and usage patterns, written by hand                                                                                                                            |
| [Authentication Guide](https://docs.taskade.com/developers/authentication.md)                           | Personal access tokens and OAuth 2.0 (PKCE), including both hosted MCP options                                                                                                                  |
| [Workspace MCP](https://docs.taskade.com/developers/workspace-mcp.md)                                   | Run `@taskade/mcp-server` to connect Claude Desktop, Cursor, and Claude Code ([source](https://github.com/taskade/mcp))                                                                         |
| [Workspace MCP - Advanced](https://docs.taskade.com/developers/workspace-mcp/workspace-mcp-advanced.md) | Setup for more than one client, troubleshooting, and security                                                                                                                                   |
| [Hosted Taskade MCP](https://docs.taskade.com/developers/workspace-mcp/genesis-app-mcp.md)              | Connect to `https://www.taskade.com/mcp` with OAuth or a Personal Access Token. Create and manage projects, edit tasks, manage and prompt agents, and edit Taskade Genesis app source           |
| [MCP Client connector](https://www.taskade.com/learn/connect/mcp-client-integration)                    | Outbound MCP through an **automation**. Point the connector at a remote MCP server. Agents do not call MCP servers directly ([which MCP?](https://docs.taskade.com/developers/mcp-overview.md)) |
| [Integration Kit (GitHub)](https://github.com/taskade/integrations)                                     | Open-source Zapier and n8n actions and triggers that use the public API. You can contribute or self-host                                                                                        |
| [Agent skills (GitHub)](https://github.com/taskade/skills)                                              | Skills that teach an AI agent to connect to Taskade and work in your workspace                                                                                                                  |
| [Webhooks](https://docs.taskade.com/developers/webhooks.md)                                             | Trigger automations from external events and call any API                                                                                                                                       |
| [Agent Embeds](https://docs.taskade.com/developers/agent-embeds.md)                                     | Add a public AI agent with an iframe or configurable widget                                                                                                                                     |
| [Bundles & App Kits](https://docs.taskade.com/developers/bundles.md)                                    | Import or export full Taskade Genesis apps as portable `.tsk` bundles                                                                                                                           |
| [Long-Term Memory](https://docs.taskade.com/developers/long-term-memory.md)                             | Taskade stores agent memory as projects. You can edit it, query it, and reach it with the API                                                                                                   |
| [Autonomous Agents](https://docs.taskade.com/developers/autonomous-agents.md)                           | Automations, orchestration, and patterns for one agent to call another                                                                                                                          |
| [TypeScript SDK (Preview)](https://docs.taskade.com/developers/sdk-quickstart.md)                       | Call the API from TypeScript with the built-in `fetch`                                                                                                                                          |
| [Contact support](https://www.taskade.com/contact)                                                      | Help from the Taskade team                                                                                                                                                                      |

## What you can build

* **Custom dashboards** that pull data from Taskade workspaces and projects
* **CI/CD integrations** that create tasks or update statuses on deploy
* **AI assistants** that manage tasks and agents through the MCP Server
* **Internal tools** that connect Taskade to your company's systems
* **Automation bots** that respond to events and keep projects in sync

## Next steps

* [Quickstart](https://www.taskade.com/docs/getting-started/quickstart): create a project and add tasks in about five minutes.
* [Authentication](https://docs.taskade.com/developers/authentication.md): use OAuth 2.0 when your app acts for other Taskade users.
* [Taskade API overview](https://docs.taskade.com/developers/comprehensive-api-guide/api.md): the REST and Action APIs, side by side.
* [Webhooks](https://docs.taskade.com/developers/webhooks.md): get an event when data changes, instead of polling.
* [Taskade App Factory](https://www.taskade.com/apps): App Kits built with Taskade, as working examples.

***

*This page is also published at* [*taskade.com/docs/getting-started/developer-platform*](https://www.taskade.com/docs/getting-started/developer-platform)*.*
