Tasks API

REST-API für Task-Management mit Zuweisungen, Ergebnissen und KI-Ausführung.

Endpoints

Tasks auflisten

GET /api/v1/tasks?status=pending&type=ai_task&limit=50&offset=0

Task erstellen

POST /api/v1/tasks
Content-Type: application/json

{
  "title": "Dokumentation prüfen",
  "description": "Alle Links in der Doku validieren",
  "type": "ai_task",
  "due_date": "2025-12-25T12:00:00Z"
}

Task-Details abrufen

GET /api/v1/tasks/{id}

Liefert Task mit Assignments und Results.

Task aktualisieren

PUT /api/v1/tasks/{id}
Content-Type: application/json

{
  "title": "Neuer Titel",
  "description": "Neue Beschreibung",
  "type": "mixed",
  "due_date": "2025-12-30T18:00:00Z"
}

Task löschen

DELETE /api/v1/tasks/{id}

Status ändern

PUT /api/v1/tasks/{id}/status
Content-Type: application/json

{
  "status": "in_progress",
  "updated_by": "claude",
  "updated_by_type": "ai"
}

Task zuweisen

POST /api/v1/tasks/{id}/assign
Content-Type: application/json

{
  "assignee": "claude",
  "assignee_type": "claude",
  "model_name": "claude-3-5-sonnet",
  "notes": "Priorität hoch"
}

Ergebnis speichern

POST /api/v1/tasks/{id}/results
Content-Type: application/json

{
  "executor": "claude",
  "executor_type": "claude",
  "model_name": "claude-3-5-sonnet",
  "response": "Task erfolgreich abgeschlossen",
  "status": "success",
  "tokens_input": 1500,
  "tokens_output": 500
}

Ergebnisse abrufen

GET /api/v1/tasks/{id}/results

KI-Ausführung

POST /api/v1/tasks/{id}/execute
Content-Type: application/json

{
  "model": "mistral",
  "auto_complete": true
}

Führt den Task mit lokalem Ollama aus.

Statistiken

GET /api/v1/tasks/statistics

Liefert Statistiken zu Tasks, Token-Verbrauch und Modell-Nutzung.

Response-Format

Erfolg

{
  "success": true,
  "data": { ... },
  "meta": {
    "total": 42,
    "limit": 50,
    "offset": 0
  }
}

Fehler

{
  "success": false,
  "error": "Fehlermeldung"
}

Task-Objekt

{
  "id": 100,
  "uuid": "76c8b3ed-...",
  "title": "Dokumentation prüfen",
  "description": "...",
  "type": "ai_task",
  "status": "pending",
  "created_by": "mcp-tasks",
  "created_by_type": "ai",
  "parent_task_id": null,
  "due_date": "2025-12-25T12:00:00",
  "created_at": "2025-12-20T10:00:00",
  "updated_at": "2025-12-20T10:00:00",
  "completed_at": null
}

UseCases

Verwandte Dokumentation

• KI-Tasks Übersicht
• MCP-Tasks Server