Getting Started

Developer Overview

4 min readStart here

Build applications, agents, and automations on Taskade. This page describes the platform and guides you to your first API call.


New to Taskade's API? Start with Personal Tokens (fast) or Authentication (OAuth 2.0), then use the API documentation.

Platform Overview

Taskade provides these components for intelligent applications:

Capability Description Learn More
AI App Builder Generate full-stack applications from natural language Taskade Genesis →
AI Agents Platform Custom assistants with knowledge retrieval AI Agents Guide →
Workflow Automation Event-driven processing with 100+ integrations Automations →
Projects & Data Structured data and custom fields, synced live between people working in the Taskade workspace Projects Guide →

People who edit a project together see each other's changes as they occur. The API accesses the same data through HTTP requests.

The API supports CRUD calls and AI-driven workflows. Webhooks push events to your service after a data change.

Quick Start

First API Call
Start with a Personal Access Token

Get an API key. Then make your first request.

Bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://www.taskade.com/api/v1/workspaces

Get a token here: Personal Tokens.

Authentication
OAuth 2.0 (production)

When you need user-based auth and scoped access, use OAuth.

Supported methods:

  • Personal Access Tokens (recommended for development)
  • OAuth 2.0 (recommended for production): Authentication
SDKs & Tools
SDKs & Libraries

Taskade provides these libraries and tools:

Official:

  • @taskade/sdk -- TypeScript SDK (Preview — not yet on public npm) (Quickstart)
  • @taskade/mcp-server -- Workspace MCP Server for Claude, Cursor, Claude Code (Setup Guide)
  • Hosted Taskade MCP -- orchestrate your workspace and edit Taskade Genesis app source from your IDE (Setup Guide)
  • REST API with OpenAPI spec
  • Webhook integrations

Resources:

Core APIs

Workspaces & Projects

Tree-structured project data with collaborative editing. Taskade Projects synchronize data for people in the Taskade workspace.

Project endpoints cover create, read, complete, restore, copy, and share links. Neither API renames or deletes a project. GET /projects/{projectId} is read-only.

Generated Taskade Genesis apps use request-and-response data access. They do not include a documented live-subscription client for app visitors.

Tasks & Data

Task records with custom fields. Create, read, update, and delete records through the documented endpoints.

Generated apps have no documented atomic batch API. Import large datasets in bounded chunks. Make sure that each write succeeds.

AI Agents

Stateful AI agents with persistent memory and tool access. Each agent maintains a knowledge graph from projects, documents, and conversations.

You can combine agents into multi-agent workflows with dependency resolution and error handling.

Automations & Integrations

Automation System

Event-driven automations. A trigger starts a run, and the steps execute in order.

The engine separates transient failures from permanent ones. It retries a transient failure with backoff. It stops a permanent failure and notifies you, so a broken connection does not burn credits.

Action & Trigger Reference

Triggers and actions. A trigger reacts to an event. An action does the work, and it carries its own error handling and timeout behavior for an external service.

Integration Reference

100+ automation connectors. Each connector handles authentication and the triggers or actions it documents. Custom HTTP steps can call other APIs. Generated apps do not expose a documented GraphQL subscription or WebSocket live-query layer.

Genesis API

Taskade Genesis

Build complete web applications from natural language prompts. Taskade Genesis handles code generation and automatic deployment.

Create Your First App →

Resources

OpenAPI Specification

Interactive API documentation with live testing.

API Guide

Official and community-maintained libraries for popular languages.

API Best Practices

Performance characteristics and scaling guidelines. Rate limits distribute capacity across users.

The guide covers connection pooling, request batching, and retry strategies.

Community & Support

Resource Description
API Documentation Interactive API documentation (Swagger)
GitHub Repository Documentation contributions, feature requests
Status Page API uptime, service announcements
Community Apps Browse apps built with Taskade
Contact Support Get help from the Taskade team

Ready to start building?

🚀 Get a Personal Token →
📚 API Documentation →
💬 Browse Community Apps →