Update a task

Updates an existing task with modified properties using full resource replacement semantics. This endpoint
replaces the entire task object with the provided data, allowing you to modify any task property including
title, description, assignee, priority, due dates, status, custom properties, and associations. Use this
for complete task updates when multiple fields need to change simultaneously.

Key Features:

  • Full task update with complete property replacement for comprehensive modifications
  • Modify task metadata including title, description, and notes
  • Reassign tasks to different users or change assignee responsibilities
  • Update priority levels (low, medium, high, critical) based on changing business needs
  • Adjust planned start and end dates when schedules shift
  • Change task status using workflow status schemas for progress tracking
  • Update custom properties to reflect evolving program requirements
  • Modify associations to link tasks with different programs, content, or requests
  • Reorganize task hierarchies by changing parent task relationships

Authorization Logic:

  1. User must have a valid JWT token with management scopes
  2. User must have permission to edit the specific task
  3. If changing assignee, new assignee must be a valid user with space access

Usage Example:

Update a task when priorities change, deadlines shift, or team members are reassigned. For example, update a "Content Review" task to change the assignee from John to Sarah, extend the due date by one week, increase priority from medium to high, and add a note about urgency. Use PUT when you need to make multiple changes at once, or PATCH for selective field updates without replacing the entire object.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

string
required

task id to update

Body Params

The task update request containing modified task properties.

string

Updated human-readable title or name for the task. Required field that should be concise yet descriptive. Changing this updates what users see in task lists and reports. Ensure the new title clearly identifies the task's purpose.

string | null

Updated detailed textual description providing comprehensive task information, instructions, or context. Can be set to null to remove existing description. Use to refine task requirements or add new information as the task evolves.

int32 | null

Updated workflow step identifier to transition the task to a new status within its status schema. Must be a valid step ID from the task's statusSchemaId. Set to null to clear status. Use to move tasks through workflow stages like 'In Progress' to 'Complete'.

string | null

Updated unique identifier of the user to assign this task to, or null to unassign. Must be a valid user ID with access to the space. Changing assignee triggers notifications to the new assignee and updates assignerId to track who made the change.

date-time | null

Updated target start date/time in ISO 8601 format when work should begin, or null to clear. Use when schedules change or to defer task start. Affects timeline calculations and visualization in program planning views.

date-time | null

Updated target completion date/time (due date) in ISO 8601 format, or null to remove deadline. Use when deadlines shift or to set/remove time constraints. May trigger recalculation of related task schedules if dependencies exist.

int32 | null

Updated estimated duration in days for task completion, or null to clear. Use for revised work estimates. Can interact with plannedStartDate/plannedEndDate for automatic date calculations depending on system configuration.

string | null

Updated unique identifier of the program to associate this task with, or null to remove program association. Use to move tasks between programs or link standalone tasks to programs for coordinated portfolio management.

string | null
enum

Updated priority level classification ('low', 'medium', 'high', 'critical') to reflect changing task importance, or null to remove priority. Use when business needs shift to re-prioritize work and help teams focus on urgent items.

Allowed:
customProperties
array of objects | null

Updated array of custom property value objects to replace existing custom property data, or null to clear all. Each object contains custom property ID and values array. Use to update organization-specific metadata like budget codes, departments, or custom categories.

customProperties
string | null

Updated unique identifier of the parent task to change task hierarchy, or null to make this a top-level task. Use to reorganize task breakdowns by moving subtasks to different parents or promoting subtasks to standalone tasks.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json