Updating an existing task

The data for this particular endpoint is a bit different to the others, it accepts an array of property / value pairs. You can pass through as many pairs as you want, only the properties you pass through will be updated.

Accepted properties:

  • name
  • notes (description)
  • priority
  • percentComplete
  • assignments (an array of resourceId GUIDs)
  • plannedStart
  • plannedFinish (due date)
  • plannedEffort
  • actualEffort

Example payload which sets the progress, priority, description and assignees:

[
    {"property":"percentComplete","value":25},
    {"property":"priority","value":4},
    {"property":"notes","value":"Nulla vitae elit libero, a pharetra augue..."},
    {"property":"assignments","value":["d5b29cff-2cef-430a-9269-3d88d362b4dc","a7a71339-5d52-4e1f-9332-ca2103c422f3"]}
]

If you specify an actual effort value it will be generic effort and not for a specific resource. If you want to log hours for a specific resource use the Timesheet Create endpoint. Date values must be in ISO Date format: var d = new Date("2015-03-25T12:00:00-06:30");

Language
Authentication
Header