🚀 Jetzt neu: FlowAI! Ein revolutionärer Chat mit personalisierten AI-Agenten. 🌟

FlowTasks API - für moderne Projektmanagement-Tools

Eine vollständige REST API für FlowTasks mit Boards, Listen und Kommentaren. Perfekt für Projektmanagement-Tools, Aufgaben-Tracker und Automatisierungen.

🚀 Schnellstart

Basis-URL: https://creativeskyline.de/api/todos https://creativeskyline.de/api/todos/boards
Abwärtskompatibilität
Die Felder list_id, board_id und assigned_to akzeptieren sowohl UUIDs als auch Integer-IDs. Bestehende Integrationen funktionieren weiterhin.

1. API-Zugangsdaten abrufen

Bevor Sie die Todo-API nutzen können, benötigen Sie Ihre persönlichen Zugangsdaten: Melden Sie sich an, navigieren Sie zu Profil → API-Zugang und kopieren Sie Ihren persönlichen API-Key (pk_...).

2. Typischer Workflow

Um ein Todo in einem Board zu erstellen, folgen Sie diesen Schritten: 1. Boards abrufen (GET /api/todos/boards), 2. Listen des Boards abrufen (GET /api/todos/boards/{boardUuid}/lists), 3. Todo erstellen (POST /api/todos).

✅ Todo-Verwaltung

Basis-URL: https://creativeskyline.de/api/todos https://creativeskyline.de/api/todos/boards
Persönliche und Board-Todos
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 einzusortieren.

Todos auflisten

GET /api/todos

Ruft alle Todos Ihres Teams ab. Unterstützt verschiedene Filter-Parameter.

Query-Parameter:

type string Filter nach Typ: personal, board, assigned, created
completed boolean Filter nach Status: true oder false
priority string Filter nach Priorität: low, medium, high
board_id string Filter nach Board (UUID oder ID)
list_id string Filter nach Liste (UUID oder ID)
GET /api/todos/search

Durchsucht Todos nach Titel oder Beschreibung.

Query-Parameter:

search string * Suchbegriff für die Todo-Suche

Todo abrufen

GET /api/todos/{uuid}

Ruft ein einzelnes Todo mit all seinen Details ab.

Todo erstellen

POST /api/todos

Erstellt ein neues Todo. Kann persönlich oder in einem Board erstellt werden.

Request Body:

title string * Titel des Todos
description string Beschreibung
due_date string Fälligkeitsdatum (ISO 8601)
priority string Priorität: high, medium, low
list_id string UUID oder ID der Ziel-Liste
board_id string UUID oder ID des Ziel-Boards
assigned_to string UUID oder ID des zugewiesenen Benutzers

Beispiel-Response:

{"success": true, "data": {"id": 1, "uuid": "550e8400-e29b-41d4-a716-446655440000", "title": "Feature implementieren", "priority": "high", "completed": false, "list": {"id": 123, "uuid": "f0e1d2c3-...", "name": "In Progress"}, "comments": [], "created_at": "2024-01-01T10:00:00Z"}, "message": "Todo erfolgreich erstellt"}

Todo aktualisieren

PUT /api/todos/{uuid}

Aktualisiert ein bestehendes Todo. Alle Felder sind optional.

Request Body:

title string Titel
description string Beschreibung
due_date string Fälligkeitsdatum
priority string Priorität: high, medium, low
completed boolean Als erledigt markieren

Todo löschen

DELETE /api/todos/{uuid}

Löscht ein Todo unwiderruflich.

📋 Boards & Listen

Basis-URL: https://creativeskyline.de/api/todos https://creativeskyline.de/api/todos/boards

Boards auflisten

GET /api/todos/boards

Ruft alle aktiven Boards Ihres Teams ab, inklusive verschachtelter Listen.

Beispiel-Response:

{"success": true, "data": [{"id": 1, "uuid": "a1b2c3d4-...", "name": "Projekt Alpha", "lists": [{"id": 10, "uuid": "f0e1d2c3-...", "name": "Backlog"}, {"id": 11, "uuid": "1a2b3c4d-...", "name": "In Progress"}]}], "count": 1}

Board-Listen abrufen

GET /api/todos/boards/{boardUuid}/lists

Ruft alle Listen eines Boards mit deren Todos ab.

💬 Kommentare

Basis-URL: https://creativeskyline.de/api/todos https://creativeskyline.de/api/todos/boards

Kommentare auflisten

GET /api/todos/{uuid}/comments

Ruft alle Kommentare eines Todos ab.

Kommentar hinzufügen

POST /api/todos/{uuid}/comments

Fügt einem Todo einen neuen Kommentar hinzu.

Request Body:

comment string * Kommentartext (max. 1000 Zeichen)