Task Object

Root Connection

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

tasks (TaskConnection!)

Root connection for retrieving Task 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 TaskFilter

Filter to determine which Task records are returned.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

order [TaskOrder!]

Order of the Task records returned.

view TaskView

View name.

The default value is current_account.

Fields

The fields in this section list which values can be retrieved when querying Task 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 task is currently expected to be assigned.

assignedAt (ISO8601Timestamp)

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

category (TaskCategory)

The category of the task. Risk & impact tasks are used to help plan workflows. Approval tasks are used to collect approvals for workflows. These can be used at various stages in the life of the workflow. Implementation tasks are added to workflows for development, installation, configuration, test, transfer and administrative work that needs to be completed for the implementation of the workflow.

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 task is expected to be completed.

createdAt (ISO8601Timestamp)

The date and time at which the record was created.

customFields ([CustomField!])

Values of custom fields.

failureTask (Task)

The task that will be assigned in case this task is failed or rejected.

finishedAt (ISO8601Timestamp)

Automatically set to the date and time at which the task is saved with the status "Failed", "Rejected", "Completed", "Approved" or "Canceled".

id (ID!)

Unique identifier of the record.

impact (TaskImpact)

The extent to which the service instances related to the task will be impacted by the completion of the task.

instructions (String)

Used to provide instructions for the person to whom the task will be assigned.

lifeCycleState (LifeCycleState)

Current state of the record.

member (Person)

The person to whom the task is to be assigned. This field's value is null in case of an approval task with multiple approvers.

noteBehavior (TaskNoteBehavior)

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

orderLine (ShopOrderLine)

The order line related to the fulfillment task.

pdfDesign (PdfDesign)

The PDF design associated with the task.

phase (WorkflowPhase)

The phase of the workflow to which the task belongs.

plannedDuration (Int)

The number of minutes it is expected to take for the 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 member is expected to spend working on the task.

providerNotAccountable (Boolean)

Whether the provider indicates not to be accountable for the affected SLAs linked to the requests that are linked to the workflow of a task that was created based on the template.

rejectionCount (Int)

Automatically set to the number of times that an approval task is rejected.

request (Request)

The request related to this task. When this request is solved the task will be completed.

requestServiceInstance (ServiceInstance)

The service instance that should be used to create the request for this task.

requestTemplate (RequestTemplate)

The request template that should be used to create the request for this task.

requiredApprovals (Int)

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

resolutionDuration (Int)

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

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 task may not start before a specific date and time.

status (TaskStatus)

The Status field is used to select the current status of the task.

subject (String)

A short description of the objective of the task.

supplier (Organization)

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

supplierRequestID (String)

The identifier under which the request to help with the execution of the task has been registered at the supplier organization. If the supplier provided a link to the request, enter the entire URL in this field.

taskId (String)

The record ID as displayed in the UI

team (Team)

The team to which the task is to be assigned.

template (TaskTemplate)

The task template that was used to register the 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 task has been marked as urgent.

waitingUntil (ISO8601Timestamp)

The date and time at which the status of the 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 task is calculated using a 24x7 calendar rather than normal business hours.

workflow (Workflow)

The workflow to which the task belongs.

Connections

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

approvals (TaskApprovalConnection)

Approvals of the 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.

configurationItems (ConfigurationItemConnection)

Configuration items of the 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.

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.

serviceInstances (ServiceInstanceConnection)

Service instances of the 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.

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

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