tasks.tasks.favorite

Adds a task to the “Watching” list or removes it from that list.

HTTP method

POST

Content type

application/x-www-form-urlencoded

Parameters

• task_id POST
  Task ID.
• favorite POST
  Flag denoting whether a task must be added (1) or removed (0) from the “Watching” list.
• contact_id GET Optional
  ID of the user to whose “Watching” list a task must be added or from whose list it must be removed. The specified user must have access to that task. If not specified then the current user is taken into account.
• unread POST Optional
  Unread task status: 1 (unread), 0 (read). By default, when a task is being added to favorites it is marked as unread, but if a task is already in the favorites list then its unread status is not changed.
• format GET Optional

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

Return value