Docs
Update Task
PUT /tasks/{taskId}
PUT
/tasks/{taskId}Required Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Updates all fields of an existing task. When parentId or index changes, sibling indices are automatically recalculated. Parent cycles and dependency cycles are both rejected.
Requires EventProjectManagementAdmin permission on the event.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| taskId | Guid | Required | The task to update. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Task name. |
| statusId | Guid | Required | ID of the task status. Must exist. |
| startDateTime | DateTime? | Optional | Scheduled start date. |
| endDateTime | DateTime? | Optional | Scheduled end date. |
| description | string | Optional | Task description. |
| priority | string | Optional | Priority level. |
| index | int | Required | Display order position (1-based). |
| parentId | Guid? | Optional | Parent task ID, or `null` for top-level. Must not create a cycle. |
| phaseId | Guid? | Optional | Phase ID, or `null`. |
| assignees | AssigneeList | Optional | Users and collaborators to assign. |
| reviewerIds | Guid[] | Optional | User IDs to assign as reviewers. |
| attributes | Attribute[] | Optional | Custom attribute values. All required attributes must be supplied. |
| dependsOn | Guid[] | Optional | Task dependency IDs. Must not create a cycle. |
AssigneeList
| Field | Type | Description |
|---|---|---|
| userIds | Guid[] | User IDs to assign. |
| collaboratorIds | Guid[] | Collaborator IDs to assign. |
Attribute
| Field | Type | Required | Description |
|---|---|---|---|
| attributeId | Guid | Required | The attribute definition ID. |
| value | string | Required | The value to set. |