changeCreate Mutation

Creates a new change.

Input Argument

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

The fields inside input are:

category (ChangeCategory)

The category of the change. A change is either planned or unplanned. Select the category "Emergency" for changes that were not planned. Changes that were planned by applying a standard change template are automatically set to the category "Standard". When a change template is used that is not approved as a standard change, then the option "Non-Standard" is automatically selected in this field.

changeType (String)

Used to indicate whether the change needs to be implemented following the procedure steps for application changes or for infrastructure changes.

clientMutationId (String)

A unique identifier for the client performing the mutation.

completionReason (ChangeCompletionReason)

Used to select the appropriate completion reason for the change when it has been completed. It is automatically set to "Complete" when all tasks related to the change have reached the status "Completed", "Approved" or "Canceled".

customFields ([CustomFieldInput!])

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

justification (ChangeJustification)

The reason why the change was requested.

managerId (ID)

Who is responsible for coordinating the implementation of the change. If a manager is not specified for a new change, the API user is selected in the Manager field by default.

note (String)

High-level description of the result that should be accomplished by the implementation of the change. It is also used to add any information that could prove useful for anyone affected by the change, including the people whose approval is needed and the specialists who are helping to implement it.

problems ([ID!])

All problems of this change.

projectId (ID)

Linked project

releaseId (ID)

The release that the change is a part of.

requests ([ID!])

All requests of this change.

serviceId (ID)

The service that will directly be affected by the change implementation, or in case of an emergency change, the service that was directly affected by the change implementation.

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)

The date and time at which the Status field of the first tasks of the change will automatically be set to "Assigned".

status (ChangeStatus)

Automatically set based on the status of the change's tasks.

subject (String)

A short description of the objective of the change.

templateId (ID)

The change template that was used to register the change.

Return Fields

change (Change)

Record after mutation.

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.