WRwrike
Tasks

Update Task

Changed on

Update task.

<b>Scopes:</b> Default, wsReadWrite

put/tasks/{taskId}

Request

  • Base URL
    https://www.wrike.com/api/v4
  • URL
    https://www.wrike.com/api/v4/tasks/{taskId}
  • Auth
    HTTP bearer

Path parameters

taskIdstring required

Query parameters

titlestring

Title of task

descriptionstring

Task Description

status'Active' | 'Deferred' | 'Completed' | 'Cancelled'
  • Active - Active
  • Deferred - Deferred
  • Completed - Completed
  • Cancelled - Cancelled

Task status. Not available for the Team plan

  • Active - Active
  • Deferred - Deferred
  • Completed - Completed
  • Cancelled - Cancelled
importance'High' | 'Low' | 'Normal'
  • High
  • Low
  • Normal

Task importance

  • High
  • Low
  • Normal

Reschedule task and/or change task type

Put task into specified folders of same account. Cannot contain RecycleBin folder

Remove task from specified folders. Can not contain RecycleBin folder

Shared task with specified users or invitations

Unshare task from specified users or invitations

Add specified users or invitations to assignee list

Remove specified users or invitations from assignee list

Add specified placeholders to placeholder assignee list

Remove specified placeholders from placeholder assignee list

Add specified users to task followers

followboolean

Follow task

priorityBeforestring

Put task in task list before specified task

priorityAfterstring

Put task in task list after specified task

Add the task as subtask to specified tasks

Remove the task form specified tasks subtasks

Metadata to be updated (null value removes entry). Limit : 100

Custom fields to be updated or deleted (null value removes field). Limit : 100

customStatusstring

Custom status ID

restoreboolean

Restore task from Recycled Bin

Set Task Effort fields: mode, total Effort

Partially update flexible effort allocations. Only the allocations explicitly provided in the request are modified; allocations for non-specified assignees or dates remain unchanged. Applicable only to tasks in Flexible effort mode.

billingType'Billable' | 'NonBillable'
  • Billable - Billable
  • NonBillable - Non-Billable

Task's timelogs billing type

  • Billable - Billable
  • NonBillable - Non-Billable
withInvitationsboolean

Include invitations in sharedIds & responsibleIds lists

convertToCustomItemTypestring

Custom Item Type id

plainTextCustomFieldsboolean

Strip HTML tags from custom fields

workScheduleIdstring

Id of work schedule to assign to task

Json string array of optional fields to be included in the response model

  • billingType - Billing type
  • workScheduleId - Id of work schedule assigned to task
  • effortAllocation - Effort Allocation
  • responsiblePlaceholderIds - List of placeholder assignee IDs

Response

success response

kind'accounts' | 'users' | 'contacts' | 'assets' | 'eDiscoveryReport' | 'folders' | 'folderTree' | 'tasks' | 'taskIds' | 'timelogs' | 'timelogCategories' | 'timelogLockPeriods' | 'timetrackerTimers' | 'comments' | 'attachments' | 'url' | 'version' | 'dataExport' | 'dataExportSchema' | 'auditLog' | 'accessRoles' | 'stream' | 'changes' | 'posts' | 'mailSettings' | 'integrationInfo' | 'gmailIntegrationSettings' | 'workTypesForIntegrations' | 'ids' | 'backups' | 'domains' | 'dependencies' | 'workflows' | 'workschedules' | 'workscheduleExclusions' | 'workscheduleUserExclusions' | 'customfields' | 'customfieldIds' | 'customstatuses' | 'invitations' | 'notifications' | 'jobroles' | 'placeholders' | 'groups' | 'session' | 'dashboards' | 'widgets' | 'taskCreationSettings' | 'colors' | 'experiments' | 'topics' | 'topicComments' | 'webhooks' | 'reviews' | 'boards' | 'textSearch' | 'chatChannels' | 'chatMessages' | 'forms' | 'requestForms' | 'request' | 'report' | 'platformWidgets' | 'platformWidgetInstances' | 'spaces' | 'pdf' | 'customerSatisfaction' | 'asyncJob' | 'approvals' | 'highlights' | 'highlightsList' | 'highlightsSettings' | 'highlightsCard' | 'timesheet' | 'timesheetRow' | 'timesheetSubmissionRule' | 'mobileFeatures' | 'mobileSettings' | 'folderBlueprintTree' | 'taskBlueprintTree' | 'blueprintSearch' | 'feedback' | 'timeline_snapshot' | 'contactIds' | 'bookings' | 'integrateThreshold' | 'hourlyRatesProvision' | 'hourlyRates' | 'projectTeamMembers' | 'contactsHistory' | 'tasksHistory' | 'foldersHistory' | 'activityDigest' | 'workItemTemplates' | 'workTemplates' | 'workItemMetadata' | 'workItem' | 'customItemTypes' | 'verificationCode' | 'views' | 'listView' | 'tableView' | 'userTypes' | 'reactions' | 'externalRequesters' | 'workscheduleCapacityOverrides' | 'userCapacityOverrides' | 'userCapacityExclusions' | 'rollups' | 'requestFormPrefill' | 'mcpFeatures' | 'attachmentUploadUrl' | 'userAggregatedCapacity' | 'cascadingFieldSettings' | 'recommendResources' | 'aggregatedAllocatedEffort' | 'aggregatedTotalUserEffort' | 'aggregatedTimeSpent' | 'folderBlueprint' | 'taskBlueprint'

Changes

  • 7b0a63c547ddRevision changes
    • warning

      added the new aggregatedAllocatedEffort enum value to the response property for the response status

    • warning

      added the new aggregatedTimeSpent enum value to the response property for the response status

    • warning

      added the new aggregatedTotalUserEffort enum value to the response property for the response status

    • warning

      added the new attachmentUploadUrl enum value to the response property for the response status

    • warning

      added the new blueprintSearch enum value to the response property for the response status

    • warning

      added the new folderBlueprint enum value to the response property for the response status

    • warning

      added the new mcpFeatures enum value to the response property for the response status

    • warning

      added the new recommendResources enum value to the response property for the response status

    • warning

      added the new taskBlueprint enum value to the response property for the response status