projectTaskUpdate Mutation

Updates an existing project task.

Input Argument

projectTaskUpdate accepts a single input argument, an input type, which contains the values it uses.

The fields inside input are:

agileBoardColumnId (ID)

ID of the column this item is placed in.

agileBoardColumnPosition (Int)

The (one based) position of this item in its column.

agileBoardId (ID)

ID of the board this item is placed on.

assignedAt (ISO8601Timestamp)

Automatically set to the current date and time when the project task is assigned.

assignmentsToDelete ([ID!])

Identifiers of assignments to remove from the project task.

category (ProjectTaskCategory)

The category of the project task. Activity tasks are used to assign project-related work to people. Approval tasks are used to collect approvals for projects. Milestones are used to mark specific points along a project's implementation plan.

clientMutationId (String)

A unique identifier for the client performing the mutation.

customFields ([CustomFieldInput!])

Values for custom fields to be used by the UI Extension that is linked to the record.

customFieldsAttachments ([AttachmentInput!])

The attachments used in the custom fields' values.

deadline (ISO8601Timestamp)

The date and time at which the milestone needs to have been reached.

id (ID!)

The node ID of the record to update.

instructions (String)

Used to provide instructions for the person(s) to whom the project task will be assigned.

newAssignments ([ProjectTaskAssignmentInput!])

Assignments of the project task.

note (String)

Used to provide information for the person to whom the project task is assigned. It is also used to provide a summary of the actions that have been taken to date and the results of these actions.

pdfDesignId (ID)

Identifier of the PDF design to link to the task.

phaseId (ID)

Identifier of the phase of the project to which the project task belongs.

plannedDuration (Int)

The number of minutes it is expected to take for the project task to be completed following its assignment, or following its fixed start date and time if the Start no earlier than field is filled out.

plannedEffort (Int)

The number of minutes the team is expected to spend working on the project task.

predecessorIds ([ID!])

Identifiers of the predecessors of the project task.

requiredApprovals (Int)

The number of assignees who need to have provided their approval before the status of the project task gets updated to "Approved".

skillPoolId (ID)

Skill pool that represents the specific expertise needed to complete the task.

source (String)

An identifier for the client application submitting the resource or the name of an external system.

sourceID (String)

The unique identifier of the resource in an external system.

startAt (ISO8601Timestamp)

Only used when work on the project task may not start before a specific date and time.

status (ProjectTaskStatus)

The current status of the project task.

subject (String)

A short description of the objective of the project task.

successorIds ([ID!])

Identifiers of the successors of the project task.

supplierId (ID)

The supplier organization that has been asked to assist with the completion of the project task.

supplierRequestID (String)

The identifier under which the request to help with the execution of the project task has been registered at the supplier organization.

teamId (ID)

The team to which the project task is to be assigned.

templateId (ID)

The project task template that was used to register the project task.

timeSpent (Int)

The time that you have spent working on the request since you started to work on it or, if you already entered some time for this request, since you last added your time spent in it.

timeSpentEffortClassId (ID)

The effort class that best reflects the type of effort for which time spent is being registered.

urgent (Boolean)

Whether the project task is urgent.

waitingUntil (ISO8601Timestamp)

The date and time at which the status of the project task is to be updated from waiting_for to assigned. This field is available only when the Status field is set to waiting_for.

workHoursAre24x7 (Boolean)

When set to true, the completion target of the project task is calculated using a 24x7 calendar rather than normal business hours.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

projectTask (ProjectTask)

Record after mutation.