Eine vollständige REST API für FlowTasks mit Boards, Listen und Kommentaren. Perfekt für Anwendungen, Projektmanagement-Tools und Task-Tracker.
Bevor Sie die Todo-API nutzen können, benötigen Sie Ihre persönlichen Zugangsdaten:
Alle API-Anfragen benötigen diese HTTP-Header:
Sicherheitshinweis: Behandeln Sie Ihre UUIDs wie Passwörter und teilen Sie sie niemals öffentlich.
Testen Sie Ihre Verbindung mit diesem einfachen Beispiel:
curl -X GET "https://creativeskyline.de/api/todos" \ -H "X-Team-UUID: ihre-team-uuid" \ -H "X-User-UUID: ihre-user-uuid" \ -H "Accept: application/json"
Um ein Todo in einem Board zu erstellen, benötigen Sie die UUID der Ziel-Liste. Der typische Ablauf besteht aus drei Schritten:
GET /api/todos/boards
GET /api/todos/boards/{'{boardUuid}'}/lists
POST /api/todos
# Schritt 1: Boards abrufen → Board-UUID erhalten curl -X GET "https://creativeskyline.de/api/todos/boards" \ -H "X-Team-UUID: ihre-team-uuid" \ -H "X-User-UUID: ihre-user-uuid" # Schritt 2: Listen des Boards abrufen → Listen-UUID erhalten curl -X GET "https://creativeskyline.de/api/todos/boards/BOARD-UUID-HIER/lists" \ -H "X-Team-UUID: ihre-team-uuid" \ -H "X-User-UUID: ihre-user-uuid" # Schritt 3: Todo in der gewünschten Liste erstellen curl -X POST "https://creativeskyline.de/api/todos" \ -H "X-Team-UUID: ihre-team-uuid" \ -H "X-User-UUID: ihre-user-uuid" \ -H "Content-Type: application/json" \ -d '{ "title": "Neues Feature implementieren", "list_id": "LISTEN-UUID-HIER", "priority": "high" }'
Abwärtskompatibilität: Die Felder list_id, board_id und assigned_to akzeptieren sowohl UUIDs als auch Integer-IDs. Bestehende Integrationen funktionieren weiterhin.
Basis-URL: https://creativeskyline.de/api/todos
/api/todos
Ruft alle Todos Ihres Teams ab. Unterstützt verschiedene Filter-Parameter.
type - Filter nach Todo-Typ: personal, board, assigned, created
completed - Filter nach Status: true oder false
priority - Filter nach Priorität: low, medium, high
board_id - Filter nach Board (UUID oder ID)
list_id - Filter nach Liste (UUID oder ID)
/api/todos/search?search={term}
Durchsucht Todos nach Titel oder Beschreibung.
search - Suchbegriff für die Todo-Suche
/api/todos/{uuid}
Ruft ein einzelnes Todo mit all seinen Details ab.
/api/todos
Erstellt ein neues Todo. Kann privat (persönlich) oder in einem Board/einer Liste erstellt werden.
{
"title": "Titel des Todos",
"description": "Beschreibung (optional)",
"due_date": "2024-12-31T23:59:59Z (optional)",
"priority": "high|medium|low (optional)",
"list_id": "listen-uuid-hier", // Optional: UUID oder ID der Liste
"board_id": "board-uuid-hier", // Optional: UUID oder ID des Boards
"assigned_to": "user-uuid-hier" // Optional: UUID oder ID des Benutzers
}
Tipp: Lassen Sie list_id und board_id leer, um ein persönliches Todo zu erstellen.
Geben Sie nur board_id an, um das Todo in der ersten Liste des Boards zu erstellen.
Alle Referenz-Felder akzeptieren sowohl UUIDs als auch Integer-IDs (Abwärtskompatibilität).
/api/todos/{uuid}
Aktualisiert ein bestehendes Todo. Alle Felder sind optional.
/api/todos/{uuid}
Löscht ein Todo unwiderruflich.
/api/todos/boards
Ruft alle aktiven Boards Ihres Teams ab, inklusive verschachtelter Listen.
{
"success": true,
"data": [
{
"id": 1,
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Projekt Alpha",
"lists": [
{
"id": 10,
"uuid": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
"name": "Backlog"
},
{
"id": 11,
"uuid": "1a2b3c4d-5e6f-7890-abcd-1234567890ab",
"name": "In Progress"
}
]
}
],
"count": 1
}
/api/todos/boards/{boardUuid}/lists
Ruft alle Listen eines Boards mit deren Todos ab.
boardUuid - UUID oder ID des Boards
{
"success": true,
"data": [
{
"id": 10,
"uuid": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
"name": "Backlog",
"todos": [
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"title": "Bug fixen",
"priority": "high",
"completed": false
}
]
}
],
"count": 1
}
{
"success": false,
"error": "Fehlende Authentifizierungs-Header: X-Team-UUID und X-User-UUID erforderlich"
}
{
"success": false,
"error": "Benutzer gehört nicht zum angegebenen Team"
}
{
"success": false,
"error": "Todo nicht gefunden"
}
{
"success": false,
"errors": {
"title": ["The title field is required."]
}
}
curl -X POST "https://creativeskyline.de/api/todos" \
-H "X-Team-UUID: ihre-team-uuid" \
-H "X-User-UUID: ihre-user-uuid" \
-H "Content-Type: application/json" \
-d '{
"title": "Einkaufen gehen",
"description": "Milch, Brot und Eier kaufen",
"due_date": "2024-12-24T18:00:00Z",
"priority": "medium"
}'
curl -X POST "https://creativeskyline.de/api/todos" \
-H "X-Team-UUID: ihre-team-uuid" \
-H "X-User-UUID: ihre-user-uuid" \
-H "Content-Type: application/json" \
-d '{
"title": "Feature implementieren",
"description": "User Authentication hinzufügen",
"list_id": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
"priority": "high",
"assigned_to": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}'
curl -X GET "https://creativeskyline.de/api/todos/search?search=urgent" \ -H "X-Team-UUID: ihre-team-uuid" \ -H "X-User-UUID: ihre-user-uuid" \ -H "Accept: application/json"
curl -X POST "https://creativeskyline.de/api/todos/{uuid}/comments" \
-H "X-Team-UUID: ihre-team-uuid" \
-H "X-User-UUID: ihre-user-uuid" \
-H "Content-Type: application/json" \
-d '{
"comment": "Task ist fast fertig, nur noch Testing"
}'
{
"success": true,
"data": {
"id": 1,
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"title": "Feature implementieren",
"description": "User Authentication hinzufügen",
"due_date": "2024-12-31T23:59:59Z",
"priority": "high",
"completed": false,
"user": {
"id": 1,
"uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"name": "Max Mustermann"
},
"assigned_user": {
"id": 456,
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Jane Doe"
},
"list": {
"id": 123,
"uuid": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
"name": "In Progress",
"board": {
"id": 1,
"uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Projekt Alpha"
}
},
"comments": [],
"created_at": "2024-01-01T10:00:00Z"
},
"message": "Todo erfolgreich erstellt"
}
Hinweis: Verwenden Sie die grün hervorgehobenen UUID-Felder als Referenzen in Ihren API-Aufrufen statt der numerischen IDs.
Erstellen Sie eine native iOS/Android-App für Ihr Team-Todo-Management mit vollständiger Offline-Synchronisation.
Automatisieren Sie Todo-Erstellung aus E-Mails, Slack-Nachrichten oder anderen Tools mit Zapier oder Make.
Erstellen Sie benutzerdefinierte Dashboards und Reports für Produktivitätsanalysen und Team-Performance.
Verbinden Sie Ihr Todo-System mit bestehenden Tools wie GitHub, GitLab, Jira oder Trello.
💬 Kommentare
/api/todos/{uuid}/commentsRuft alle Kommentare eines Todos ab.
/api/todos/{uuid}/commentsFügt einem Todo einen neuen Kommentar hinzu.
Request Body:
{ "comment": "Ihr Kommentar hier (max. 1000 Zeichen)" }