taskCreate Mutation

Creates a new task.

Input Argument

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

clientMutationId (String)

A unique identifier for the client performing the mutation.

configurationItemIds ([ID!])

Identifiers of the configuration items of the task.

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.

finishedAt (ISO8601Timestamp)

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

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.

instructionsAttachments ([AttachmentInput!])

The attachments used in the instructions field.

memberId (ID)

Identifier of 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.

newApprovals ([TaskApprovalInput!])

Approvals of the task.

note (String)

Used to provide information for the person to whom the 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.

noteAttachments ([AttachmentInput!])

The attachments used in the note field.

pdfDesignId (ID)

Identifier of the PDF design associated with the task.

phaseId (ID)

Identifier of 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.

predecessorIds ([ID!])

Identifiers of predecessors of the task.

requestServiceInstanceId (ID)

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

requestTemplateId (ID)

The identifier of 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".

serviceInstanceIds ([ID!])

Identifiers of service instances of 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 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.

successorIds ([ID!])

Identifiers of successors of the task.

supplierId (ID)

Identifier of 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.

teamId (ID)

Identifier of the team to which the task is to be assigned.

templateId (ID)

Identifier of the task template that was used to register the 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 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.

workflowId (ID!)

Identifier of the workflow to which the task belongs.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

task (Task)

Record after mutation.