productUpdate Mutation

Updates an existing product.

Input Argument

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

The fields inside input are:

brand (String)

The brand name is typically the name of the product's manufacturer.

category (String)

The appropriate product category for the product.

clientMutationId (String)

A unique identifier for the client performing the mutation.

customFields ([CustomFieldInput!])

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

depreciationMethod (ProductDepreciationMethod)

Used to specify whether or not configuration items that are based on the product are typically depreciated and if so, which depreciation method is normally applied. Valid values are:

  • na_cost_is_zero: N/A - Cost is Zero/Included in Other CI or Service
  • na_not_capitalized: N/A - Not Capitalized
  • na_leased: N/A - Leased
  • double_declining_balance: Double Declining Balance
  • reducing_balance: Reducing Balance (or Diminishing Value)
  • straight_line: Straight Line (or Prime Cost)
  • sum_of_the_years_digits: Sum of the Year's Digits
disabled (Boolean)

Whether the product may no longer be used to register new configuration items.

financialOwnerId (ID)

Identifier of the internal organization which budget is normally used to obtain the product.

id (ID!)

The node ID of the record to update.

model (String)

The model of the product.

name (String)

The name of the product. Fill out the Brand, Model, Product ID (optional) and Category fields to automatically generate a name based on the values entered in these fields.

pictureUri (String)

The hyperlink to the image file for the record.

productID (String)

The unique identifier of the product that is used by the manufacturer.

rate (Int)

The yearly rate that should normally be applied to calculate the depreciation of configuration items that are based on the product using the reducing balance (or diminishing value) method.

remarks (String)

Any additional information about the product that might prove useful.

serviceId (ID)

Identifier of the Service which Service Instances would typically include the product.

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

supplierId (ID)

Identifier of the organization from which the product is typically obtained. If the product is developed internally, select the internal organization that develops it. Note that a lease company should be selected in this field if the product is normally leased.

supportTeamId (ID)

Identifier of the team responsible for maintaining the product's information in the configuration management database (CMDB).

uiExtensionId (ID)

UI extension that is to be applied to the record.

usefulLife (Int)

The number of years within which configuration items that are based on the product are typically depreciated.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

product (Product)

Record after mutation.