Update a Work Manager Task
put
/api/restapi/workManagerTask
Send a request to this endpoint to update a work manager task.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : ApiEntityWorkManagerTaskInput
Type:
object
Title:
ApiEntityWorkManagerTaskInput
This entity represents a WorkManagerTask object, a unique WorkManagerTask object can be identified by the following combinations of the fields.
Show Source
- workManagerTaskId
- itemCode,project,projectCompanyId
- itemCode,projectCode,workspaceCode,projectCompanyId
- itemCode,project,companyName,companyPostalCode,projectCompanyColor
- itemCode,projectCode,workspaceCode,companyName,companyPostalCode,projectCompanyColor
-
activityCode: stringRead Only:true
Minimum Length:0
Maximum Length:60
Deprecated. As of 23.12.The user-specified identifier of the activity. -
activityCompleteStatus: stringRead Only:true
Allowed Values:[ "NO_ACTIVITY", "ACTIVITY_COMPLETE_TASK_NOT", "TASK_COMPLETE_ACTIVITY_NOT", "BOTH_COMPLETE", "BOTH_NOT_COMPLETE" ]
Deprecated. As of 23.12.Indicates the completion status of the activity and its assigned tasks. -
activityDateStatus: stringRead Only:true
Allowed Values:[ "INSIDE_ACTIVITY", "OUTSIDE_ACTIVITY", "NO_ACTIVITY" ]
Deprecated. As of 23.12.Indicates the overall date status of the activity's assigned tasks.
Outside Activity: A task's dates are outside of the activity's Start and Finish dates.
Inside Activity: All of the tasks' dates are within the activity's Start and Finish dates.
No Tasks Assigned: No tasks are assigned to the activity. -
activityId: integer
(int64)
The activity to which the task is assigned. The activity must have a Type of Activity Dependent or Resource Dependent.
-
codeValues: array
codeValues
The list of code values for a work manager task. This entity can only be used to assign codeValues or create codeValues on the fly.
-
commitmentCount: integer(int64)Read Only:true
Deprecated. As of 23.12.The number of commitments on a task. -
companyName: string
Minimum Length:
1
Maximum Length:255
The name of the company. -
companyPostalCode: string
Minimum Length:
0
Maximum Length:20
The postal code, post code, or zip code of a location. -
completedDate: string
(date-time)
The date when the task was completed. This field is set automatically when the task is completed.
-
configuredFields: array
configuredFields
The list of configured fields for a work manager task.
-
constraintCount: integer(int64)Read Only:true
Deprecated. As of 23.12.The number of constraints assigned to the selected task or task milestone. -
durationHours: number
(double)
Minimum Value:
0
The total amount of expected time required to complete the task, in days. -
favorite: boolean
Indicates whether or not the work manager task is marked as favorite.
-
hasCommitments: booleanRead Only:true
Deprecated. As of 23.12.Tasks that contain commitments to due dates. -
hasConstraints: booleanRead Only:true
Deprecated. As of 23.12.Indicates whether the selected task or task milestone has any constraints assigned. -
hasProposedDueDate: boolean
Tasks that have a proposed due date value that has not yet been accepted.
-
hasSlack: booleanRead Only:true
Deprecated. As of 23.12.Task slack is the amount of time a task can be delayed before it impacts the start date of the most immediate hand-off successor. -
isDueThisWeek: booleanRead Only:true
Deprecated. As of 23.12.Tasks that are due within the calendar week from Sunday to Saturday. -
isMissingActivityAssignment: booleanRead Only:true
Deprecated. As of 23.12.Tasks that are missing Activity assignment. -
isOutsideActivity: booleanRead Only:true
Deprecated. As of 23.12.Tasks with due dates that occur before the activity start date or after the activity end date. -
isOverdue: booleanRead Only:true
Deprecated. As of 23.12.Tasks that have not been completed by their due date. -
isPending: booleanRead Only:true
Deprecated. As of 23.12.Tasks that have a due date but are not committed, or tasks that are committed but the due date has been changed. -
isSchNonWorkDays: booleanRead Only:true
Deprecated. As of 23.12.Tasks that occur on non-work days as defined by the project calendar when Use Only Work Days is selected. -
isUnassigned: booleanRead Only:true
Deprecated. As of 23.12.Tasks that do not have a user assigned. -
isUnplanned: booleanRead Only:true
Deprecated. As of 23.12.Tasks without a due date. -
itemCode: string
Minimum Length:
1
Maximum Length:60
The user-specified unique identifier assigned to the task. -
latestCommitmentDueDate: string(date-time)Read Only:true
Deprecated. As of 23.12.The current due date of the task commitment. -
link: string(url)Read Only:true
Deprecated. As of 23.10.The self-link to the object. This field is populated only in the responses generated by the batch create APIs. -
originalCommitmentDueDate: string(date-time)Read Only:true
Deprecated. As of 23.12.The original due date of the task commitment. -
overdue: boolean
Tasks that have not been completed by their due date.
-
parentWbsId: integer
(int64)
The system-generated identifier of the parent WBS.
-
predecessorCount: integer(int64)Read Only:true
Deprecated. As of 23.12.The number of predecessor hand-offs assigned to the task. -
project(required): integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
projectCode: string
Minimum Length:
1
Maximum Length:60
The unique identifier for a project set by the user who created the project. -
projectCompanyColor: string
Minimum Length:
1
Maximum Length:6
The selected color representation of the company. -
projectCompanyId: integer
(int64)
The name of the company that owns the task.
-
proposedDueDate: string
(date-time)
The date proposed for the task due date. Proposed Due Dates do not affect task Due Dates until they are accepted.
-
sequenceNumber: integer(int32)Read Only:true
Deprecated. As of 23.12.The number that specifies the position of a task within a task hierarchy. -
slack: number(double)Read Only:true
Minimum Value:0
Deprecated. As of 23.12.The amount of time a task can be delayed before it affects the start date of its most immediate successor. This is a read-only field. -
startDate: string(date-time)Read Only:true
Deprecated. As of 23.12.The date when the task is set to begin.
If the task is set to allow non-work days, the date is calculated as Due Date minus Duration plus 1 day.
If the task is not set to allow non-work days, the date is calculated as Due Date minus the sum of Duration plus Non-Work Days, plus 1 day.
This is a read-only field. -
status: string
Allowed Values:
[ "NEW", "PENDING", "COMMITTED", "COMPLETED" ]
The current status of the task. Valid values are New, Pending, Committed, and Completed. -
successorCount: integer(int64)Read Only:true
Deprecated. As of 23.12.The number of successor hand-offs assigned to the task. -
taskConstraints: array
taskConstraints
List of work manager task constraints.
-
tentativeDate: string
(date-time)
The date by which the task is expected to be completed.
-
type: string
Allowed Values:
[ "TASK", "TASK_MILESTONE" ]
The type of task. Valid values are Task and Task Milestone. -
updateDate: string(date-time)Read Only:true
Deprecated. As of 23.10.Date when the record was last updated. -
useCalendar: boolean
Enables the user to allow only the project calendar's work days and ignore non-work days when determining the value for Start and Due Date.
-
userId: integer
(int64)
The person responsible for the task.
-
visibility(required): string
Allowed Values:
[ "PUBLIC", "PRIVATE" ]
The visibility of task. Valid values are Private and Public. -
wbsCode: string
Minimum Length:
1
Maximum Length:60
The user-specified unique identifier for the WBS. -
wbsId: integer
(int64)
Unique identifier of the WBS.
-
wbsPath: string
Maximum Length:
4000
The path to the WBS. -
workManagerTaskCommitments: arrayworkManagerTaskCommitmentsRead Only:true
Deprecated. As of 23.12.List of Work Manager task commitments associated with the task. -
workManagerTaskId: integer
(int64)
The unique identifier of a task. This value should not be provided in create operation request data, however, it is required for update requests.
-
workManagerTaskName: string
Minimum Length:
1
Maximum Length:255
The name of the task. -
workspaceCode: string
Minimum Length:
0
Maximum Length:60
The user-specified identifier of a workspace. -
workspaceId: integer
(int64)
The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.
Nested Schema : codeValues
Type:
array
The list of code values for a work manager task. This entity can only be used to assign codeValues or create codeValues on the fly.
Show Source
-
Array of:
object ApiEntityCodeValueWorkManagerTaskInput
Title:
ApiEntityCodeValueWorkManagerTaskInput
This entity represents a CodeValueWorkManagerTask object, a unique CodeValueWorkManagerTask object can be identified by the following combinations of the fields.- codeValueTasksId
- codeValueId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeTypeCode,parentId,codeValueCode
- codeValueCode,codeTypeId,parentId
- codeTypeCode,codeValueCode,projectCode
- codeTypeCode,codeValueCode,projectId
- codeTypeCode,codeValueCode,parentId,projectCode
- codeTypeCode,codeValueCode,parentId,projectId
Nested Schema : configuredFields
Type:
array
The list of configured fields for a work manager task.
Show Source
-
Array of:
object ApiEntityWorkManagerTaskConfiguredFieldValueInput
Title:
ApiEntityWorkManagerTaskConfiguredFieldValueInput
This entity represents a WorkManagerTaskConfiguredFieldValue object, a unique WorkManagerTaskConfiguredFieldValue object can be identified by the following combinations of the fields.- workManagerTaskConfiguredFieldValueId
- columnDefinitionId
- columnName
- columnLabel
Nested Schema : taskConstraints
Type:
array
List of work manager task constraints.
Show Source
-
Array of:
object ApiEntityTaskConstraintInput
Title:
ApiEntityTaskConstraintInput
This entity represents a TaskConstraint object, a unique TaskConstraint object can be identified by the following combinations of the fields.- taskConstraintId
- constraintId,workManagerTaskId
Nested Schema : workManagerTaskCommitments
Type:
array
Read Only:
true
Deprecated. As of 23.12.List of Work Manager task commitments associated with the task.
Show Source
-
Array of:
object ApiEntityWorkManagerTaskCommitment
Title:
ApiEntityWorkManagerTaskCommitment
Nested Schema : ApiEntityCodeValueWorkManagerTaskInput
Type:
object
Title:
ApiEntityCodeValueWorkManagerTaskInput
This entity represents a CodeValueWorkManagerTask object, a unique CodeValueWorkManagerTask object can be identified by the following combinations of the fields.
Show Source
- codeValueTasksId
- codeValueId
- codeTypeId,codeValueCode
- codeTypeCode,codeValueCode
- codeTypeCode,parentId,codeValueCode
- codeValueCode,codeTypeId,parentId
- codeTypeCode,codeValueCode,projectCode
- codeTypeCode,codeValueCode,projectId
- codeTypeCode,codeValueCode,parentId,projectCode
- codeTypeCode,codeValueCode,parentId,projectId
-
action: string
Allowed Values:
[ "DELETE" ]
Provide a value for this field during object update to delete code value assigned to the object. -
codeTypeCode: string
Minimum Length:
0
Maximum Length:60
This field displays the name of a code or value. -
codeTypeId(required): integer
(int64)
The unique identifier for the code type.The code type object can also be identified by its unique criteria.
-
codeTypeName: stringMinimum Length:0
Maximum Length:255
Deprecated. As of 23.11.The name of a code or value. -
codeValueCode(required): string
Minimum Length:
1
Maximum Length:60
The unique identifier for the code value. -
codeValueId: integer
(int64)
The unique identifier for the code value.
-
codeValueName: string
Minimum Length:
1
Maximum Length:255
The name of the code value. -
codeValueTasksId: integer
(int64)
The unique identifier of a code value of a task.
-
link: string(url)Read Only:true
Deprecated. As of 23.10.The self-link to the object. This field is populated only in the responses generated by the batch create APIs. -
parentId: integer
(int64)
The unique identifier of a parent code value.
-
projectCode: string
Minimum Length:
1
Maximum Length:60
The code of a Project of a Project CodeType. -
projectId: integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
sequenceNumber: integer(int32)Deprecated. As of 23.11.The number that specifies the position of the code value item within the code type list. -
updateDate: string(date-time)Read Only:true
Deprecated. As of 23.10.Date when the record was last updated. -
workManagerTaskId: integer
(int64)
The unique identifier of a task.
Nested Schema : ApiEntityWorkManagerTaskConfiguredFieldValueInput
Type:
object
Title:
ApiEntityWorkManagerTaskConfiguredFieldValueInput
This entity represents a WorkManagerTaskConfiguredFieldValue object, a unique WorkManagerTaskConfiguredFieldValue object can be identified by the following combinations of the fields.
Show Source
- workManagerTaskConfiguredFieldValueId
- columnDefinitionId
- columnName
- columnLabel
-
action: string
Allowed Values:
[ "DELETE" ]
Provide value for this field during object update to delete the assigned configured field value. -
columnDefinitionId: integer
(int64)
Unique identifier of the column. This value should not be provided in create operation request data, however, it is required for update requests.
-
columnLabel: string
Minimum Length:
1
Maximum Length:100
The user-specified UDF column label. -
columnName: string
Minimum Length:
1
Maximum Length:100
The user-specified UDF column name. -
costValue: numberRead Only:true
Deprecated. As of 23.10.This holds values for Cost type configured fields in the base currency conversion. Input should be provided in numberValue field, in currency of record. -
costValueWorkspace1: number(double)Read Only:true
Deprecated. As of 23.10.This holds values for Cost type configured fields in the workspace1 currency conversion. -
costValueWorkspace2: number(double)Read Only:true
Deprecated. As of 23.10.This holds values for Cost type configured fields in the workspace2 currency conversion. -
costValueWorkspace3: number(double)Read Only:true
Deprecated. As of 23.10.This holds values for Cost type configured fields in the workspace3 currency conversion. -
dateValue: string
(date-time)
This holds values for Date type configured fields.
-
exceptionMessage: stringRead Only:true
Maximum Length:4000
Deprecated. As of 23.10.Provides the error message for why the formula calculation resulted in an error. -
hasException: booleanRead Only:true
Deprecated. As of 23.10.Determines if formula calculation hit an error calculating a value for this field. -
link: string(url)Read Only:true
Deprecated. As of 23.10.The self-link to the object. This field is populated only in the responses generated by the batch create APIs. -
numberValue: number
This holds values for Number, Integer and Cost type configured fields. Input for the cost configured field should be provided in the currency of record. For example project level currency in case of Activity, base currency for Company, workspace currency for Funds and record level currency for Project Actuals etc. configured fields.
-
textValue: string
Maximum Length:
4000
This holds values for Boolean, List and Text type configured fields. -
updateDate: string(date-time)Read Only:true
Deprecated. As of 23.10.Date when the record was last updated. -
workManagerTaskConfiguredFieldValueId: integer
(int64)
The unique identifier for the Task Configured Field.
-
workManagerTaskId: integer
(int64)
The system-generated identifier of a Task.
Nested Schema : ApiEntityTaskConstraintInput
Type:
object
Title:
ApiEntityTaskConstraintInput
This entity represents a TaskConstraint object, a unique TaskConstraint object can be identified by the following combinations of the fields.
Show Source
- taskConstraintId
- constraintId,workManagerTaskId
-
action: string
Allowed Values:
[ "DELETE" ]
Provide value for this field during object update to delete the assigned configured field value. -
constraintId: integer
(int64)
The unique identifier of a constraint.
-
link: string(url)Read Only:true
Deprecated. As of 23.10.The self-link to the object. This field is populated only in the responses generated by the batch create APIs. -
taskConstraintId: integer
(int64)
The unique identifier of a work manager task constraint.
-
updateDate: string(date-time)Read Only:true
Deprecated. As of 23.10.Date when the record was last updated. -
workManagerTaskId: integer
(int64)
The unique identifier of a task.
Nested Schema : ApiEntityWorkManagerTaskCommitment
Type:
object
Title:
Show Source
ApiEntityWorkManagerTaskCommitment
-
activityCode: string
Minimum Length:
0
Maximum Length:60
The user-specified identifier of the activity. -
addByUserId: integer
(int64)
The username of the user who added the item.
-
applicationUserId: integer
(int64)
The system-generated identifier of a user.
-
comments: string
Minimum Length:
1
Maximum Length:4000
The comments captured with a task commitment. -
companyName: string
Minimum Length:
1
Maximum Length:255
The name of the company. -
companyPostalCode: string
Minimum Length:
0
Maximum Length:20
The postal code, post code, or zip code of a location. -
createDate: string
(date-time)
The date on which work manager task commitment was created.
-
dueDate: string
(date-time)
The date by which the task is expected to be completed.
-
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
projectCode: string
Minimum Length:
1
Maximum Length:60
The unique identifier for a project set by the user who created the project. -
projectCompanyColor: string
Minimum Length:
1
Maximum Length:6
The selected color representation of the company. -
projectCompanyId: integer
(int64)
The system-generated identifier of a project.
-
projectId: integer
(int64)
The unique identifier for the project.The project object can also be identified by its unique criteria.
-
reasons: array
reasons
The reasons of a work manager task commitment.
-
status: string
Allowed Values:
[ "COMMITTED", "RECOMMITTED" ]
The status of the commitment. Valid values are Committed and Recommitted. -
taskName: string
Minimum Length:
1
Maximum Length:255
The name of the task. -
timezoneDateAdded: string
(date-time)
The date on which the commitment was added.
-
updateDate: string
(date-time)
Date when the record was last updated.
-
workManagerTaskCode: string
Minimum Length:
1
Maximum Length:60
The user-specified unique identifier assigned to the task. -
workManagerTaskCommitmentId: integer
(int64)
The unique identifier of a commitment. This value should not be provided in create operation request data, however, it is required for update requests.
-
workManagerTaskId: integer
(int64)
The unique identifier for the work manager task.The work manager task object can also be identified by its unique criteria.
-
workspaceCode: string
Minimum Length:
0
Maximum Length:60
The user-specified identifier of a workspace.
Nested Schema : reasons
Type:
array
The reasons of a work manager task commitment.
Show Source
-
Array of:
object ApiEntityReason
Title:
ApiEntityReason
Nested Schema : ApiEntityReason
Type:
object
Title:
Show Source
ApiEntityReason
-
abbreviation: string
Minimum Length:
1
Maximum Length:60
The abbreviation of the reason for recommitting to a task. -
appliesTo: array
appliesTo
Indicates the type of object the reason is associated to.
-
associationType: string
Allowed Values:
[ "OWNED", "INHERITED" ]
The type of association in the relationship between the reason and the workspace. Possible values are Owned and Inherited. -
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
pushDownType: string
Allowed Values:
[ "MANUAL", "AUTOMATIC" ]
How data is shared between parent and child workspaces.
Manual: Data can be pulled down by child workspaces. This is the default option.
Automatic: Data is automatically shared with all child workspaces. -
reasonId: integer
(int64)
The unique identifier of a reason.
-
reasonName: string
Minimum Length:
1
Maximum Length:255
The name of the reason for recommitting to a task. -
updateDate: string
(date-time)
Date when the record was last updated.
-
workspaceCode: string
Minimum Length:
0
Maximum Length:60
The user-specified identifier of a workspace. -
workspaceId: integer
(int64)
The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.
Nested Schema : appliesTo
Type:
array
Indicates the type of object the reason is associated to.
Show Source
-
Array of:
string
Allowed Values:
[ "TASKS", "CHANGE_EVENT" ]
Examples
Back to Top
Response
204 Response
Successful operation with no content.
400 Response
Invalid input for the Work Manager Task service.