PUT /api/tasks/:id
Update a task

Params

Param name Description
id
required

Task ID

Validations:

  • Must be a Integer
task
required

Task parameters.

Validations:

  • Must be a Hash
task[cost_center_id]
optional

Cost center (project) ID.

Validations:

  • Must be a Integer
task[name]
required

Task name.

Validations:

  • Must be a String
task[notes]
optional

Additional notes.

Validations:

  • Must be a String
task[start_date]
optional

Start date, e.g. “2025-01-20”.

Validations:

  • Must be a String
task[end_date]
optional

End date, e.g. “2025-02-28”.

Validations:

  • Must be a String
task[state]
optional

Task state. Default: "in_progress".

Validations:

  • Must be one of: in_progress, completed, not_started.
task[external_id]
optional

Task ID in an external service.

Validations:

  • Must be a String
task[monthly_limit_minutes]
optional

Monthly time limit (estimated time in offer), in minutes.

Validations:

  • Must be a Integer
task[is_time_limit_hard]
optional

Is the time limit hard (true) or soft (false). Default: false (soft).

Validations:

  • Must be one of: true, false, 1, 0.
task[is_billable]
optional

Is the task billable (true) or non-billable (false). Default: false (non-billable).

Validations:

  • Must be one of: true, false, 1, 0.
task[billable_amount_cents]
optional

Amount billed to the customer, in cents. Only applicable for billable tasks. Example: for a billable amount of €100.00, send 10000.

Validations:

  • Must be a Integer
task[billable_amount_currency]
optional

Billable amount’s currency code per ISO 4217 standard. Example: send "EUR" for Euro. Default: "EUR".

Validations:

  • Must be a String
task[billable_amount_unit]
optional

Billlable amount’s unit. Default: "hour".

Validations:

  • Must be one of: hour, day, fixed.