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.

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 changes. Approval tasks are used to collect approvals for changes. These can be used at various stages in the life of the change. Implementation tasks are added to changes for development, installation, configuration, test, transfer and administrative work that needs to be completed for the implementation of the change.

change (Change)

The change to which the task belongs.

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.

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 object.

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.

pdfDesign (PdfDesign)

The PDF design associated with the task.

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.

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".

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.

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.

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.