The following macros are not currently supported in the header:
- style
Create Task
- Kun Liu (Unlicensed)
- Kurt Wagner (Unlicensed)
Owned by Kun Liu (Unlicensed)
The following endpoint can be used to creates new task.
POST /tasks
Parameters
Table of allowed parameters. Required fields are underlined.
| title | String | The title for the task. |
|---|---|---|
| against_id | Integer | The id of the object the task exists against. This must point to a valid object. |
| against_type | String | The type of object the task exists against. This must point to a valid object. |
| date_started | Unix timestamp | The date of when the task is supposed to start |
| manager_id | Unsigned integer | The manager id of the task |
| assignee_id | Unsigned integer | The assignee id of the task |
| affiliation_id | Unsigned integer | The affiliation id of the task |
| date_due | Unix timestamp | The date of when the task is due. |
| budgeted | Unsigned integer | Time in seconds, The budgeted time of the task. |
| rate_id | Unsigned integer | The charge rate id of the task. This parameter is only available to tasks against "job" or "milestone" objects. |
| rate_charged | Decimal | The charge rate of the task. This parameter is only available to tasks against "job" or "milestone" objects. |
| is_billable | String, "yes" or "no" | This indicates whether this task is billable. This parameter is only available to tasks against "job" or "milestone" objects. |
| description | String | The description of the task |
| status_id | Unsigned Integer | The initial status for task. Please see list task statuses. |
| _fields | partial string | Allows you to specify optional fields and linked objects to include in the response. |
rate_id, rate_charged and is_billable can only be set on tasks against a job or milestone. Changing the rate may change your jobs budget.
Handling the response
Please see the GET task for controlling the response.