🚀 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 Anwendungen, Projektmanagement-Tools und Task-Tracker.

🚀 Schnellstart

1. API-Zugangsdaten abrufen

Bevor Sie die Todo-API nutzen können, benötigen Sie Ihre persönlichen Zugangsdaten:

  1. Melden Sie sich in Ihrem Account an
  2. Navigieren Sie zu Profil → API-Zugang
  3. Kopieren Sie Ihre Team-UUID und Benutzer-UUID

🔑 Authentifizierung

Alle API-Anfragen benötigen diese HTTP-Header:

X-Team-UUID: ihre-team-uuid-hier
X-User-UUID: ihre-benutzer-uuid-hier
Content-Type: application/json

Sicherheitshinweis: Behandeln Sie Ihre UUIDs wie Passwörter und teilen Sie sie niemals öffentlich.

3. Erste API-Anfrage

Testen Sie Ihre Verbindung mit diesem einfachen Beispiel:

curl -X GET "https://leads.creativeskyline.com/api/todos" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Accept: application/json"

📚 API-Referenz

Basis-URL: https://leads.creativeskyline.com/api/todos

✅ Todo-Verwaltung

GET /api/todos

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

Optional 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-ID
list_id - Filter nach Listen-ID
GET /api/todos/search?search={term}

Durchsucht Todos nach Titel oder Beschreibung.

Parameter:

required search - Suchbegriff für die Todo-Suche
GET /api/todos/{uuid}

Ruft ein einzelnes Todo mit all seinen Details ab.

POST /api/todos

Erstellt ein neues Todo. Kann privat (persönlich) oder in einem Board/einer Liste erstellt werden.

Request Body:

{
  "title": "Titel des Todos",
  "description": "Beschreibung (optional)",
  "due_date": "2024-12-31T23:59:59Z (optional)",
  "priority": "high|medium|low (optional)",
  "list_id": 123, // Optional: ID der Liste
  "board_id": 456, // Optional: ID des Boards
  "assigned_to": 789 // Optional: User-ID für Zuweisung
}

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.

PUT /api/todos/{uuid}

Aktualisiert ein bestehendes Todo. Alle Felder sind optional.

DELETE /api/todos/{uuid}

Löscht ein Todo unwiderruflich.

📋 Boards & Listen

GET /api/todos/boards

Ruft alle aktiven Boards Ihres Teams ab.

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

Ruft alle Listen eines Boards mit deren Todos ab.

💬 Kommentare

GET /api/todos/{uuid}/comments

Ruft alle Kommentare eines Todos ab.

POST /api/todos/{uuid}/comments

Fügt einem Todo einen neuen Kommentar hinzu.

Request Body:

{
  "comment": "Ihr Kommentar hier (max. 1000 Zeichen)"
}

💻 Code-Beispiele

Persönliches Todo erstellen

curl -X POST "https://leads.creativeskyline.com/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"
  }'

Board-Todo erstellen

curl -X POST "https://leads.creativeskyline.com/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": 123,
    "priority": "high",
    "assigned_to": 456
  }'

Todos durchsuchen

curl -X GET "https://leads.creativeskyline.com/api/todos/search?search=urgent" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Accept: application/json"

Kommentar hinzufügen

curl -X POST "https://leads.creativeskyline.com/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"
  }'

Beispiel-Response

{
  "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,
      "name": "Max Mustermann",
      "email": "max@example.com"
    },
    "assigned_user": {
      "id": 456,
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "list": {
      "id": 123,
      "name": "In Progress",
      "board": {
        "id": 1,
        "name": "Projekt Alpha"
      }
    },
    "comments": [],
    "created_at": "2024-01-01T10:00:00Z"
  },
  "message": "Todo erfolgreich erstellt"
}

🎯 Anwendungsfälle

📱 Mobile Apps

Erstellen Sie eine native iOS/Android-App für Ihr Team-Todo-Management mit vollständiger Offline-Synchronisation.

🤖 Automation

Automatisieren Sie Todo-Erstellung aus E-Mails, Slack-Nachrichten oder anderen Tools mit Zapier oder Make.

📊 Reporting

Erstellen Sie benutzerdefinierte Dashboards und Reports für Produktivitätsanalysen und Team-Performance.

🔗 Integrationen

Verbinden Sie Ihr Todo-System mit bestehenden Tools wie GitHub, GitLab, Jira oder Trello.