Create Project Task
You can use this endpoint to create a new task for a project.
Request
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.