API Reference
Build integrations with Kanman's REST API. Create, read, update, and delete your data programmatically.
The Kanman API gives you programmatic access to your boards, projects, tasks, and more. Build custom integrations, automate workflows, sync with other tools, or create entirely new experiences on top of your Kanman data.
Whether you’re building a reporting dashboard, connecting to your CI/CD pipeline, integrating with Zapier, or creating a custom mobile app, the API provides everything you need to work with your data programmatically.
Pro Feature: API access requires a Pro or Teams plan.
Overview
| Property | Value |
|---|---|
| Base URL | https://api.kanman.de/v1 |
| Protocol | HTTPS only (TLS 1.2+) |
| Format | JSON request and response bodies |
| Authentication | Bearer token (API keys) |
| Rate Limiting | Based on plan tier |
Quick Start
Get started in seconds with a simple curl command:
# List all boards
curl https://api.kanman.de/v1/boards \
-H "Authorization: Bearer km_your_api_token"
To get an API token, go to Settings > API Tokens in the Kanman app.
API Sections
This documentation is organized into the following sections:
- Authentication - Learn how to create and use API tokens, understand scopes, and secure your integrations
- Boards - Create, read, update, and delete boards
- Projects - Manage projects within boards
- Tasks - Work with tasks and subtasks
- Rate Limits - Understand usage quotas and how to stay within limits
- Errors - Handle errors gracefully with standardized error responses
Rate Limits
API usage is rate-limited based on your plan:
| Plan | API Calls/Month | Requests/Second |
|---|---|---|
| Pro | 12,000 | 10 |
| Teams | 60,000 | 30 |
Need more capacity? Top-up packages are available. Contact support for details.
Common Use Cases
The API supports a wide range of integrations:
- Reporting & Analytics - Pull task completion data into your business intelligence tools
- CI/CD Integration - Automatically create tasks when builds fail or deployments complete
- Form Submissions - Create tasks from web forms, customer requests, or support tickets
- Two-Way Sync - Keep Kanman in sync with other project management tools
- Custom Dashboards - Build tailored views for stakeholders or teams
- Automation - Trigger actions based on task changes using webhooks and the API together
Support
For API support:
- Email: [email protected]
- Status Page: status.kanman.de for real-time API status
- Documentation Issues: Report documentation problems to help us improve
Authentication PRO
Learn how to authenticate with the Kanman API using API tokens.
Boards API PRO
API endpoints for listing and retrieving boards.
Projects API PRO
API endpoints for listing and retrieving projects and their tasks.
Tasks API PRO
API endpoints for creating, reading, updating, and deleting tasks.
Rate Limits PRO
Understand API rate limits and quotas for different plans.
Error Handling PRO
Handle API errors gracefully with detailed error codes and messages.