Updates milestone properties in the app settings. Full access to Teamwork is required.


  • id GET

    Milestone ID.

  • name GET

    Milestone name.

  • project_id GET

    ID of the project to which the milestone must belong.

  • description GET Optional

    Milestone description.

  • due_date GET Optional

    Deadline in the “yyyy-mm-dd” format.

  • format GET Optional

    Sets response format. Available options: json (default), xml.

Return value

Array with the following keys:

  • id int Milestone ID.
  • name string Milestone name.
  • description string Milestone description.
  • project_id int Project ID.
  • closed bool Flag denoting whether the milestone is completed.
  • counts array Task counters data as an array with the following keys.
  • counts['active'] int Number of active tasks.
  • counts['active_priority'] int Number of active tasks with a high priority.
  • counts['closed'] int Number of closed tasks.
  • counts['total'] int Total number of tasks.
  • due_date date Deadline.
  • due_info array Deadline date properties as an array with the following keys:
  • due_info['color'] string HTML color value.
  • due_info['days_left'] int Number of remaining days.
  • due_info['text'] string Localized description of the remaining period of time.