Create Task
The following macros are not currently supported in the header:
  • style

Create Task

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.