Getting Started

Developer Overview

4 min readStart here

Build on Taskade's platform for applications, agents, and automation.


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

Platform Overview

Taskade provides a complete platform for building 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 with real-time sync and custom fields Projects Guide →

The API is built around real-time data synchronization and a unified intelligence layer that powers everything from simple CRUD operations to complex AI-driven workflows.

Quick Start

First API Call
Start with a Personal Access Token

Set up your development environment, get API keys, and make your first request in under 5 minutes.

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)

Use OAuth when you need user-based auth and scoped access.

Supported methods:

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

Official 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 Genesis app source from your IDE (Setup Guide)
  • REST API with OpenAPI spec
  • Webhook integrations

Resources:

Core APIs

Workspaces & Projects

Tree-structured data with real-time synchronization. Projects support conflict-free collaborative editing with instant synchronization across all connected clients. Each project maintains versioned change history for reliable collaboration.

Tasks & Data

Event-sourced task management with rich field types. Tasks support complex data relationships, custom field schemas, and atomic batch operations. The system maintains audit trails and supports time-travel queries for debugging and analytics.

AI Agents

Stateful AI agents with persistent memory and tool access. Each agent maintains its own knowledge graph derived from project data, documents, and conversation history. Agents can be composed into multi-agent workflows with dependency resolution and error handling.

Automations & Integrations

Automation System

Event-driven architecture with guaranteed delivery. Built on a distributed event system for reliable message processing. Supports exactly-once delivery semantics, failure handling, and automatic retry with exponential backoff.

Action & Trigger Reference

Reactive programming model with high reliability. Triggers provide real-time event detection and processing. Actions include robust error handling and timeout patterns for reliable external service integration.

Integration Reference

100+ pre-built connectors with OpenAPI 3.0 compliance. Each integration includes rate limiting, authentication handling, and automatic schema validation. Custom integrations support GraphQL subscriptions and WebSocket streaming.

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 capabilities.

API Guide

Official and community-maintained libraries for popular languages.

API Best Practices

Performance characteristics and scaling guidelines. The platform is built for high-throughput applications with enterprise-grade performance. Rate limits are implemented to ensure fair usage across all users. Includes guidance on connection pooling, request batching, and optimal 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 →