Edit Project

The Edit Project dialog lets you update an existing project’s name, type, color, status, owner, dates, tags, and description. It opens over the Project Detail page and sends only the fields you changed (patch-only submission).

Accessing the Page

Open Project Detail and click the Edit button in the page header. The dialog opens over /projects/projects/:projectId.

Fields

Field	Required	Type	Description	Default	Validation
Name	Yes	Text	Display name for the project	Current value	Max 200 chars; trimmed on save; save disabled when empty
Project Type	Yes	Select	Work item type set for this project	Current value	Locked (read-only) when the project already has tasks
Color	No	Color picker + Text	Visual accent color	Current value	Hex color code; max 9 chars; editable via color swatch or hex input
Status	No	Select	Current project status	Current value	Options constrained by allowed transitions from the persisted status
Owner	No	User select	User responsible for the project	Current value	Active users only; clearable; required when tenant settings enforce a project owner
Start Date	No	Date	Planned start date	Current value	Converted to ISO on patch
End Date	No	Date	Planned end date	Current value	Converted to ISO on patch
Tags	No	Multi-select	Lowercase tag chips	Current value	Max 50 tags; replaced (not appended) when changed
Description	No	Textarea	Detailed description	Current value	Max 4000 chars; empty value becomes null

Status Transition Rules

The available status options depend on the project’s current (persisted) status, not the in-dialog value. You cannot undo a transition while the dialog is open.

From	Allowed transitions
Draft	Draft, Active, Cancelled
Active	Active, On Hold, Completed, Cancelled
On Hold	On Hold, Active, Cancelled
Completed	Completed, Archived
Cancelled	Cancelled, Archived
Archived	Archived only (locked)

Transitions to Completed, Cancelled, and Archived are irreversible. When you select one of these statuses, the dialog shows a confirmation prompt before saving.

Project Type Locking

When the project already has tasks, the Project Type selector is disabled and shows the message:

Project type cannot be changed once tasks have been created.

Patch-Only Submission

Only the fields you changed are sent in the API patch:

• If you open the dialog and close it without making any changes, the Save button remains disabled and no API call is made.
• Fields you did not touch retain their current values on the server.

Validation Rules

Rule	Behavior
Name required	Save button disabled while Name is empty
Name length	Max 200 characters
Description length	Max 4000 characters
Tag count	Max 50 tags
Project Type required	Save button disabled if Project Type is cleared
No changes	Save button disabled when no fields have been changed
Irreversible status	Confirmation dialog shown before saving Completed, Cancelled, or Archived
Owner required (conditional)	If tenant settings require a project owner, Owner becomes required
Participants required for activation	If tenant governance requires participants before activation and the project has none, moving to Active is blocked
Unsaved changes guard	Closing with unsaved changes shows a confirmation dialog

Post-save Behavior

• Only changed fields are sent in the update payload.
• After a successful save the dialog closes and the Project Detail page refreshes with the updated values.

Common Tasks

1. Open Project Detail and click Edit.
2. Update any fields — for example, change the Status or assign an Owner.
3. If you are moving to a terminal status (Completed, Cancelled, Archived), confirm the irreversible-transition dialog.
4. Click Save. The dialog closes and the detail page shows the updated data.

Permissions & System Behavior

• Editing projects requires access to the Projects module and canWriteProjects permission.
• The Owner field is required only when tenant settings have Require project owner enabled.
• Only changed fields are included in the API patch, minimizing side effects.

Related Pages

• Create Project — Create a new project
• Project Detail — View a specific project
• Projects List — View and search all projects
• Project Participants — Add participants required before activating a project
• Project Governance Settings — Configure owner and participant requirements (superuser only)