tasks.projects.update

Updates project properties. Full access to Teamwork is required.

HTTP method

POST

Content type

application/x-www-form-urlencoded

Parameters

• id POST
  Project ID.
• workflow POST
  Array of IDs of the statuses, which must be available for processing tasks within the project, listed in the order in which the statuses must be sorted.
• name POST
  Project name.
• color POST Optional
  Color name to highlight tasks belonging to the project: t-white, t-gray, t-yellow, t-green, t-blue, t-red, t-purple.
• icon_url POST Optional
  Project logo URL.
• icon_hash POST Optional
  Hash of a project logo file uploaded using the tasks.attachments.add method to be used if the icon_url parameter is not completed.
• sort POST
  Sort value for the project list (integer).
• format GET Optional

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

Return value

Array with the following keys:

• id int Project ID.
• name string Project name.
• archive_datetime string|null Date and time of moving the project to the archive in the ISO 8601 format.
• color string Color name to highlight tasks.
• contact array The properties of the user who has created the project as an array with the following keys:
• contact['id'] int User ID.
• contact['is_me'] bool Flag denoting that the project has been created by the current user.
• contact['name'] string User name.
• contact['photo_url'] string URL of a 96x96 pixels large user image.
• counts array Array of task counters for this project 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.
• create_datetime string Project creation data and time in the ISO 8601 format.
• icon string Logo URL.
• sort int Sort value.