Edit Task

The Edit Task dialog lets you update an existing task’s title, type, status, priority, assignee, estimates, dates, parent, tags, and description. It loads the current task values on open and sends only the fields you changed (patch-only submission).

Accessing the Page

Open Task Detail and click the Edit button in the page header. The dialog opens over /projects/tasks/:taskId. You can also open it from the row actions menu (three-dot icon) on the My Tasks and Backlog pages.

Fields

Field	Required	Type	Description	Default	Validation
Title	Yes	Text	Short name for the task	Current value	Max 240 chars; trimmed on save
Work Item Type	No	Select	Type of work item (e.g., Task, Bug, Story)	Current value	Loaded from the project’s type configuration
Status	No	Select	Workflow status	Current value	One of: Backlog, To Do, In Progress, Review, Done, Cancelled
Priority	No	Select	Task priority level	Current value	One of: Low, Medium, High, Urgent
Assignee	No	User select	User assigned to this task	Current value	Active users only; required if tenant settings enforce owner by status
Estimate (hours)	No	Number	Estimated effort in hours	Current value	Min 0; step 0.25; converted to minutes on save
Remaining (hours)	No	Number	Remaining effort in hours	Current value	Min 0; step 0.25; converted to minutes on save
Parent Task	No	Entity select	Parent task in the same project	Current value	Tasks in the same project; current task excluded
Planned Start	No	Date + Time	Planned start date and time	Current value	5-minute steps; must be before Planned End if both are set
Planned End	No	Date + Time	Planned end date and time	Current value	5-minute steps; must be on or after Planned Start
Due	No	Date + Time	Task deadline	Current value	5-minute steps
Tags	No	Multi-select	Lowercase tag chips	Current value	Max 50 tags; replaced (not appended) when changed
Description	No	Textarea	Detailed task description	Current value	Max 4000 chars; empty value becomes null

Status options:

Value	Description
Backlog	Not yet scheduled
To Do	Scheduled but not started
In Progress	Actively being worked on
Review	Under review or QA
Done	Completed
Cancelled	Cancelled and will not be completed

Priority options:

Value	Description
Low	Nice to have
Medium	Standard priority
High	Important; do soon
Urgent	Critical; do immediately

Validation Rules

Rule	Behavior
Title required	Save button disabled while Title is empty
Title length	Max 240 characters
Description length	Max 4000 characters
Tag count	Max 50 tags
No changes	Save button disabled when no fields have been changed
Date range	Save button disabled if Planned End is before Planned Start
Assignee required (conditional)	Required when tenant ownership settings enforce an assignee for the chosen status. A recovery prompt appears inline if the status change requires an owner that has not been set.
Unsaved changes guard	Closing with unsaved changes shows a confirmation dialog

Patch-Only Submission

The dialog tracks which fields you actually changed. When you save:

• Only the changed fields are included in the API patch payload.
• Fields you did not touch are not sent — their current values on the server are not affected.
• If you open the dialog and close it without making any changes, the Save button remains disabled and no API call is made.

Owner-Required Recovery Dialog

When you change Status to one that requires an assignee (based on tenant governance settings) and the task currently has no assignee, a recovery prompt appears inside the dialog:

1. The recovery dialog asks you to assign an owner before the status transition can be saved.
2. You pick a user and confirm.
3. The dialog closes, the owner is assigned, and the status change is applied — without requiring you to close and reopen the edit dialog.

Post-save Behavior

• Only changed fields are included in the patch payload sent to the API.
• After a successful save the dialog closes and the Task Detail page (or the calling list) refreshes with the updated values.

Common Tasks

1. Open Task Detail for the task you want to update and click Edit.
2. Change the fields you need — for example, update Status to In Progress and assign an Assignee.
3. Adjust Planned End or Due if the schedule has changed.
4. Click Save. The dialog closes and the task detail page reflects the changes.

Permissions & System Behavior

• Editing tasks requires access to the Projects module and canWriteTasks permission.
• The Assignee field may become required based on tenant ownership enforcement settings for the chosen status.
• Only changed fields are sent in the patch, so unmodified data is never overwritten.
• If the status change requires an owner and the task has no assignee, a recovery dialog appears so the owner can be assigned without closing the edit dialog.

Related Pages

• Create Task — Create a new task
• Task Detail — View a specific task
• My Tasks — View and manage your assigned work
• Bulk Edit Tasks — Edit multiple tasks at once
• Project Governance Settings — Configure ownership and assignment rules