ProjectTask Object

Root Connection

All ProjectTask objects of an account are accessible by a query on the root connection projectTasks. Such a query will return a ProjectTaskConnection!, which contains the ProjectTask objects in its nodes field.

projectTasks (ProjectTaskConnection!)

Root connection for retrieving ProjectTask records.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

filter ProjectTaskFilter

Filter to determine which ProjectTask records are returned.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

order [ProjectTaskOrder!]

Order of the ProjectTask records returned.

view ProjectTaskView

View name.

The default value is current_account.

Fields

The fields in this section list which values can be retrieved when querying ProjectTask records.

account (Account)

The account this record belongs to.

agileBoard (AgileBoard)

Board this item is placed on.

agileBoardColumn (AgileBoardColumn)

Column this item is placed in.

agileBoardColumnPosition (Int)

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

anticipatedAssignmentAt (ISO8601Timestamp)

The date and time at which the project task is currently expected to be assigned.

assignedAt (ISO8601Timestamp)

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

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.

checkedItems ([String!])

The names of the checked items from any of the checklists in the instructions.

completionTargetAt (ISO8601Timestamp)

The date and time at which the project task is expected to be completed.

createdAt (ISO8601Timestamp)

The date and time at which the record was created.

customFields ([CustomField!])

Values of custom fields.

deadline (ISO8601Timestamp)

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

finishedAt (ISO8601Timestamp)

The Finished field is automatically set to the date and time at which the project task is saved with the status "Failed", "Rejected", "Completed", "Approved" or "Canceled".

id (ID!)

Unique identifier of the record.

instructions (String)

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

lifeCycleState (LifeCycleState)

Current state of the record.

noteBehavior (ProjectTaskNoteBehavior)

Influences the behavior of the note field on completion or approval.

pdfDesign (PdfDesign)

The PDF design associated with the task.

phase (ProjectPhase)

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.

project (Project)

The project to which the project task belongs.

projectTaskId (String)

The record ID as displayed in the UI

requiredApprovals (Int)

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

resolutionDuration (Int)

The number of minutes it took to complete this project task, which is calculated as the difference between the assignedAt and finishedAt values.

skillPool (SkillPool)

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.

supplier (Organization)

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. If the supplier provided a link to the request, enter the entire URL in this field.

team (Team)

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

template (ProjectTaskTemplate)

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

updatedAt (ISO8601Timestamp)

The date and time of the last update of the record. If the record has no updates it contains the createdAt value.

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.

Connections

The connection fields in this section allow (paged) access to objects related to a specific ProjectTask record. The actual objects will be in the nodes field of the connection.

assignments (ProjectTaskAssignmentConnection)

Assignments of the project task.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

automationRules (AutomationRuleConnection)

Automation rules associated with this record.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

customFieldsAttachments (AttachmentConnection)

Inline images linked to one of the custom fields.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

instructionsAttachments (AttachmentConnection)

Inline images linked to the Instructions field.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

notes (NoteConnection)

Notes of the record.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

predecessors (ProjectTaskConnection)

Predecessors of the project task.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

sprintBacklogItems (SprintBacklogItemConnection)

Sprint backlog items associated with this object.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

successors (ProjectTaskConnection)

Successors of the project task.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

timeEntries (TimeEntryConnection)

Time entries for this record.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

Implements

ProjectTask implements the following interfaces. This means that fragments defined on these interfaces may be used in queries returning a ProjectTask.