Neue API-Version v7.7.0 wurde veröffentlicht! 🎉
REST Dokumentation
POST Projektaufgabe erstellen

Projektaufgabe erstellen

Sie können diesen Endpunkt verwenden, um eine neue Aufgabe für ein Projekt zu erstellen.

Anfrage

POST /api/v1/projects/{project}/tasks
curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/projects/{project}/tasks' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
         "name": "Frontend-Entwicklung",
         "description": "Entwicklung der neuen Benutzeroberflächen-Komponenten",
         "task_number": "TASK-001",
         "parent_task_id": null,
         "start_date": "2024-10-01",
         "end_date": "2024-11-15",
         "deadline": "2024-11-10",
         "estimated_hours": 120.0,
         "hourly_rate": 150.00,
         "budget": 18000.00,
         "assignees": ["john.doe", "alice.smith"],
         "priority": "high",
         "status": "in_progress",
         "completion_percentage": 25,
         "is_billable": true,
         "allow_time_tracking": true,
         "requires_approval": false,
         "color": "#FF6B6B",
         "tags": ["frontend", "ui", "react"],
         "notes": "Fokus auf responsives Design und Barrierefreiheit"
     }'

Antwort

{
    "data": {
        "id": 456,
        "project_id": 9876,
        "name": "Frontend-Entwicklung",
        "description": "Entwicklung der neuen Benutzeroberflächen-Komponenten",
        "task_number": "TASK-001",
        "parent_task_id": null,
        "start_date": "2024-10-01",
        "end_date": "2024-11-15",
        "deadline": "2024-11-10",
        "estimated_hours": 120.0,
        "actual_hours": 0.0,
        "hourly_rate": 150.00,
        "budget": 18000.00,
        "spent": 0.00,
        "assignees": ["john.doe", "alice.smith"],
        "priority": "high",
        "status": "in_progress",
        "completion_percentage": 25,
        "is_billable": true,
        "allow_time_tracking": true,
        "requires_approval": false,
        "color": "#FF6B6B",
        "tags": ["frontend", "ui", "react"],
        "notes": "Fokus auf responsives Design und Barrierefreiheit",
        "created": "2024-10-01T10:30:00.000000Z",
        "modified": "2024-10-01T10:30:00.000000Z"
    }
}

Pfad-Parameter

  • Name
    project
    Type
    integer
    Description

    Die Projekt-ID.

Erforderliche Parameter

  • Name
    name
    Type
    string
    Description

    Name der Aufgabe.

Optionale Parameter

Aufgabeninformationen

  • Name
    description
    Type
    string
    Description

    Detaillierte Beschreibung der Aufgabe.

  • Name
    task_number
    Type
    string
    Description

    Eindeutige Aufgabennummer. Wird automatisch generiert, wenn nicht angegeben.

  • Name
    parent_task_id
    Type
    integer
    Description

    ID der übergeordneten Aufgabe für Unteraufgaben.

Zeitplan

  • Name
    start_date
    Type
    date | Y-m-d
    Description

    Startdatum der Aufgabe.

  • Name
    end_date
    Type
    date | Y-m-d
    Description

    Enddatum der Aufgabe.

  • Name
    deadline
    Type
    date | Y-m-d
    Description

    Deadline für die Fertigstellung der Aufgabe.

Budget und Zeit

  • Name
    estimated_hours
    Type
    float
    Description

    Geschätzte Stunden für die Fertigstellung.

  • Name
    hourly_rate
    Type
    float
    Description

    Stundensatz für diese Aufgabe (überschreibt Projektsatz).

  • Name
    budget
    Type
    float
    Description

    Für diese Aufgabe zugewiesenes Budget.

  • Name
    is_billable
    Type
    boolean
    Description

    Ob die Aufgabe abrechenbar ist. Standard ist true.

  • Name
    allow_time_tracking
    Type
    boolean
    Description

    Ob Zeiterfassung für diese Aufgabe erlaubt ist. Standard ist true.

Zuweisung und Status

  • Name
    assignees
    Type
    array
    Description

    Array von Benutzernamen, die dieser Aufgabe zugewiesen sind.

  • Name
    priority
    Type
    string | enum
    Description

    Aufgabenpriorität. Mögliche Werte: low, medium, high, critical.

  • Name
    status
    Type
    string | enum
    Description

    Aufgabenstatus. Mögliche Werte: not_started, in_progress, paused, completed, cancelled.

  • Name
    completion_percentage
    Type
    integer
    Description

    Fertigstellungsgrad (0-100).

  • Name
    requires_approval
    Type
    boolean
    Description

    Ob die Fertigstellung der Aufgabe eine Genehmigung erfordert. Standard ist false.

Weitere Einstellungen

  • Name
    color
    Type
    string | Hex
    Description

    Aufgabenfarbe im Hex-Format für die UI-Anzeige.

  • Name
    tags
    Type
    array
    Description

    Array von Tags zur Aufgabenkategorisierung.

  • Name
    notes
    Type
    string
    Description

    Interne Notizen zur Aufgabe.