New API version v7.7.0 has been released! 🎉
REST Documentation
POST Create Project Task

Create Project Task

You can use this endpoint to create a new task for a project.

Request

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 Development",
         "description": "Develop the new user interface components",
         "status_id": "active",
         "billing_type": 1,
         "start_date": "2024-10-01",
         "end_date": "2024-11-15",
         "parent_id": null
     }'

Response

{
    "data": {
        "id": 456,
        "project_id": 9876,
        "name": "Frontend Development",
        "description": "Develop the new user interface components",
        "status_id": "active",
        "billing_type": 1,
        "start_date": "2024-10-01",
        "end_date": "2024-11-15",
        "parent_id": null,
        "created": "2024-10-01T10:30:00.000000Z",
        "modified": "2024-10-01T10:30:00.000000Z"
    }
}

Path Parameters

  • Name
    project
    Type
    integer
    Description

    The project ID.

Required Parameters

  • Name
    project_id
    Type
    integer
    Description

    The project ID. Automatically set from the route parameter {project}. Must exist in projects table.

  • Name
    name
    Type
    string
    Description

    Name of the task. Max 64 characters. Must contain valid characters.

  • Name
    status_id
    Type
    string
    Description

    Task status ID. Must exist in project task statuses table. Defaults to default status if not provided.

Optional Parameters

  • Name
    description
    Type
    string
    Description

    Detailed description of the task.

  • Name
    billing_type
    Type
    integer | enum
    Description

    Billing type (ProjectTaskBillingType enum). Default is 1 (LIKE_PROJECT). Other values may include specific billing types.

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

    Start date of the task. Must be on or after the project start date if the project has a start date.

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

    End date of the task. Must be after start_date and on or before the project end date if the project has an end date.

  • Name
    parent_id
    Type
    integer
    Description

    ID of the parent task for creating subtasks. Must exist in project tasks table and cannot reference the task being created.