Model: TaskUpdateRequest

1 min

Model Parameters

TaskUpdateRequest
- labelsResourceLabelRequest[]
  Description
  Labels to associate
  - groupstringrequired
    Example
    2467e583a60e23fda2b89db81a453cd2
    Description
    Label group
    Min Length
    32
    Max Length
    32
  - valuesstring[]required
    Example
    [ "71c378f3fee3d822759d1bdc2aab628c" ]
    Description
    List of values of the label
- owner_idstring
  Example
  6853b3e37ed5e42cff067434
  Description
  ID of the owner for the task
- titlestring
  Description
  Title of the task
- start_atstring<date-time>
  Example
  2025-10-06T13:00:00Z
  Description
  Start date of the task
  Format
  date-time
- due_atstring<date-time>
  Example
  2025-10-06T13:00:00Z
  Description
  Due date and time of the task
  Format
  date-time
- dependent_tasksstring<keep | shift>
  Example
  keep
  Description
  How to handle tasks that depend on this task when due_at moves it by one or more business days. Only used together with due_at.
  
  keep: move only this task. Dependent tasks keep their dates.
  
  shift: move each dependent task by the same number of business days. Business days follow the organization's working days; organization-specific blocked dates are not taken into account. Completed dependent tasks and dependent tasks you cannot edit are left unchanged.
  
  If omitted and the change affects dependent tasks, the request is rejected with 409 and nothing is updated. The 409 response lists the affected tasks.
  Allowed
  keepshift
- campaign_idstring
  Example
  6684f31be89a526d030cfc0f
  Description
  ID of the campaign to be associated with the task
- workflow_idstring
  Example
  665d56034854d100ad7cb8fb
  Description
  ID of the workflow to be used in the task
- statusstring<not-started | in-progress | completed | on-hold | archived | unarchive | resume>
  Example
  in-progress
  Description
  New status of the task. unarchive and resume take the task out of archived or on-hold and restore the status that matches its progress.
  Allowed
  not-startedin-progresscompletedon-holdarchivedunarchiveresume