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:
- User must have a valid JWT token with management scopes
- User must have permission to edit the specific task
- 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.