Updates project properties. Full access to Teamwork is required.


  • 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.