Create Task
Creates a task in Rocketlane.
Query
Comma-separated response fields to include.
Body
This query parameter allows you to specify which fields should be returned in the response body by selecting from the drop down. To get the relevant fields, use comma separated values. If the field is left blank, the default properties are returned.
This query parameter allows you to specify if all the fields should be returned in the response body. If the field is left blank, the default properties are returned.
The task's unique, system-generated **identifier**, which can be used to identify the task globally
The **name** of the task.
The `description` of the task. The description body needs to be in **html** format to avoid any formatting issues in the application.
The `privateNote` for the task is intended exclusively for team members. The note's content should be in `HTML` format to prevent any formatting issues in the application.
The date when a task starts its execution. It can be empty. The format for the start date is _YYYY-MM-DD_.
The date when a task completes its execution. It can be empty. If both `startDate` and `dueDate` are specified for a given task, it is necessary that the latter should be on or after the given `startDate`. The format for the due date is _YYYY-MM-DD_.
The effort is the expected time required to complete the task. The value is determined in minutes.
The task's progress, if indicated, will be available here and ranges in value from 0 to 100. The task's status can be used in place of this field, however progress can offer more precise data.
Indicates whether the task has been marked as At Risk. This parameter is used to indicate that immediate action is necessary to unblock the task's execution.
The type of the task if specified will be available here. There are two options: `MILESTONE` or `TASK`. If a task is not explicitly marked as a milestone, it takes the default value as `TASK`. Milestones refer to critical tasks in the project that include an inbuilt CSAT capability that allows customers to offer CSAT evaluations depending on the task's execution.
The `project` associated with task needs to be specified here and it is mandatory for the task to get created and map accordingly.
The `phase` that needs to be associated with the task can be mentioned here. Note: The `phase` needs to be associated with the `project` and thus failing the task creation process.
The value of the task status can be specified here and this is essential to keep track of it.
The custom fields can be set during the task creation with the help of `fields`. The `fieldValue` can be either a string or a number or an array and it has to comply with the type of the field. Refer [examples](https://developer.rocketlane.com/v1.0/docs/custom-fields#examples-of-requests-and-responses-for-assigning-custom-field-values) to know how to assign `fieldValue` based on their `field_type`.
The task followers can be either `members` (team members or customers) or `placeholders`.
Parent task id
An externalReferenceId is a unique identifier that links entities or transactions between external systems and Rocketlane, ensuring accurate data correlation and consistency.
Source information for importing a task from a template
This depicts if the task is private or not.