API reference · Projects
PUT/api/v1/projects/tasks/{taskId}

Update project task

Updates a project task by task UUID. Use project_status_mapping_id when changing task status, and only send fields defined in the request schema.

RBAC · project

Path parameters

taskIdstring <uuid>Required
Project task UUID.

Request body

Content type: application/json · schema ProjectTaskUpdateRequest

task_namestring
min length 1 · max length 255
descriptionstring
assigned_tostring <uuid>
estimated_hoursnumber
≥ 0
due_datestring <date-time>
priority_idstring <uuid>
task_type_keystring
default "general"
project_status_mapping_idstring <uuid>
wbs_codestring
tagsarray of string
itemsstring

Response body

Success response 200 · schema ProjectTaskEnvelope

dataobjectRequired
task_idstring <uuid>Required
phase_idstring <uuid>Required
task_namestringRequired
descriptionstringRequiredNullable
assigned_tostring <uuid>RequiredNullable
estimated_hoursnumberRequiredNullable
actual_hoursnumberRequiredNullable
project_status_mapping_idstring <uuid>Required
due_datestring <date-time>Nullable
priority_idstring <uuid>RequiredNullable
task_type_keystringRequired
wbs_codestringRequired
order_keystring
created_atstring <date-time>Required
updated_atstring <date-time>Required
tenantstring <uuid>Required
tagsarray of string
itemsstring

Response codes

200
Project task updated successfully.
400
Validation error.
401
Authentication failed.
403
Authenticated user lacks the required permission.
404
Project task not found.