# Developer Overview

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

{% hint style="info" %}
**New to Taskade's API?** Start with [Personal Tokens](/apis-and-developer/authentication/personal-tokens.md) (fast) or [Authentication (OAuth 2.0)](/apis-and-developer/authentication.md), then use the [API documentation](https://www.taskade.com/api/documentation/).
{% endhint %}

## 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 →](/taskade-genesis/genesis.md)                                |
| **AI Agents Platform**  | Custom assistants with knowledge retrieval             | [AI Agents Guide →](https://www.taskade.com/learn/agents/custom-agents)         |
| **Workflow Automation** | Event-driven processing with 100+ integrations         | [Automations →](https://www.taskade.com/learn/automation/automations-execution) |
| **Projects & Data**     | Structured data with real-time sync and custom fields  | [Projects Guide →](https://www.taskade.com/learn/projects/databases)            |

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

{% tabs %}
{% tab title="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](/apis-and-developer/authentication/personal-tokens.md).
{% endtab %}

{% tab title="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](/apis-and-developer/authentication.md)
  {% endtab %}

{% tab title="SDKs & Tools" %}

#### **SDKs & Libraries**

Official libraries and tools:

**Official:**

* `@taskade/sdk` -- TypeScript SDK (Preview — not yet on public npm) ([Quickstart](/apis-and-developer/sdk-quickstart.md))
* [@taskade/mcp-server](https://github.com/taskade/mcp) -- Workspace MCP Server for Claude, Cursor, Claude Code ([Setup Guide](/apis-and-developer/workspace-mcp.md))
* Genesis App MCP (Beta) -- edit Genesis app source from your IDE ([Setup Guide](/apis-and-developer/workspace-mcp/genesis-app-mcp.md))
* REST API with OpenAPI spec
* Webhook integrations

**Resources:**

* [Autonomous Agents Guide](/apis-and-developer/autonomous-agents.md) -- Agent use cases and architecture patterns
* [Community Apps](https://www.taskade.com/community) -- Browse Genesis apps built by the community
* [Sample App](https://github.com/taskade/taskade-sample-app) -- Genesis app example
  {% endtab %}
  {% endtabs %}

## 🛠️ Core APIs

### [**Workspaces & Projects**](/apis-and-developer/comprehensive-api-guide/workspaces.md)

**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**](/apis-and-developer/comprehensive-api-guide/tasks.md)

**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**](/apis-and-developer/comprehensive-api-guide/agents.md)

**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**](/automations/automation.md)

**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**](/automations/automation/actions.md)

**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**](/automations/automation/comprehensive-integrations.md)

**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**](/taskade-genesis/genesis.md)

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

[**Create Your First App →**](https://www.taskade.com/learn/genesis/first-app)

## 📚 Resources

### [**OpenAPI Specification**](https://www.taskade.com/api/documentation/v1)

Interactive API documentation with live testing capabilities.

### [**API Guide**](/apis-and-developer/comprehensive-api-guide/api.md)

Official and community-maintained libraries for popular languages.

### [**API Best Practices**](/apis-and-developer/comprehensive-api-guide/api.md#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**](https://www.taskade.com/api/documentation/) | Interactive API documentation (Swagger)       |
| [**Community Forum**](https://www.taskade.com/community)            | Developer discussions, integration sharing    |
| [**GitHub Repository**](https://github.com/taskade/docs)            | Documentation contributions, feature requests |
| [**Status Page**](https://taskade.statuspage.io)                    | API uptime, service announcements             |
| [**Community Apps**](https://www.taskade.com/community)             | Browse apps built with Taskade                |

***

**Ready to start building?**

🚀 [**Get a Personal Token →**](/apis-and-developer/authentication/personal-tokens.md)\
📚 [**API Documentation →**](https://www.taskade.com/api/documentation/)\
💬 [**Join Developer Community →**](https://www.taskade.com/community)


---

# Agent Instructions: 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:

```
GET https://docs.taskade.com/apis-and-developer/developer-home/developers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
