configurationItemCreate Mutation

Creates a new configuration item. Important: To facilitate integrations with discovery tools, the create is treated as an update in case the provided name or label is already used by an inactive CI in the same account.

Input argument

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

The fields inside input are:

assetID (String)

Asset identifier of the configuration item.

clientMutationId (String)

A unique identifier for the client performing the mutation.

contractIds ([ID!])

Identifiers of the contracts of this configuration item.

customFields ([CustomFieldInput!])

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

depreciationMethod (ProductDepreciationMethod)

Default: na_cost_is_zero — Whether or not the configuration item should be depreciated and if so, which depreciation method is to be applied. When creating a new CI and a value is not specified for this field, it is set to the depreciation method of the CI's product.

financialOwnerId (ID)

Identifier of the internal organization which budget is used to pay for the configuration item. If the CI is leased or rented, the organization that pays the lease or rent is selected in this field. When creating a new CI and a value is not specified for this field, it is set to the financial owner of the CI's product.

label (String)

The label that is attached to the configuration item (CI). A label is automatically generated using the same prefix of other CIs of the same product category, followed by the next available number as the suffix.

licenseExpiryDate (ISO8601Date)

The date through which the temporary software license certificate is valid. The license certificate expires at the end of this day.

licenseType (CiLicenseType)

The type of license that the license certificate covers.

licensedSiteIds ([ID!])

Identifiers of the sites at which the software that is covered by the license certificate may be used.

location (String)

The name or number of the room in which the CI is located, if it concerns a hardware CI.

name (String)

The name of the configuration item (CI). When creating a new CI and a value is not specified for this field, it is set to the name of the CI's product.

newCiRelations ([CiRelationInput!])

Relations to other configuration items.

nrOfCores (Int)

The total number of processor cores that are installed in the server.

nrOfLicenses (Int)

The number of licenses that the license certificate covers.

nrOfProcessors (Int)

The number of processors that are installed in the server.

pictureUri (String)

The hyperlink to the image file for the record.

poNr (String)

Number of the purchase order that was used to order the (lease of the) configuration item from the supplier.

productId (ID!)

Identifier of the related product.

purchaseValue (MonetaryAmount)

The amount that was paid for the configuration item (this is normally equal to the invoice amount).

rate (Int)

Used to specify the yearly rate that should be applied to calculate the depreciation of the configuration item (CI) using the reducing balance (or diminishing value) method. When creating a new CI and a value is not specified for this field, it is set to the rate of the CI's product.

remarks (String)

Any additional information about the configuration item that might prove useful. When creating a new CI and a value is not specified for this field, it is set to the remarks of the CI's product.

ruleSet (ProductCategoryRuleSet)

The Rule set field is automatically set to the rule set of the related product's product category, except when the CI is a license certificate, in which case the rule set is license_certificate.

salvageValue (MonetaryAmount)

The value of this configuration item at the end of its useful life (i.e. at the end of its depreciation period). When a value is not specified for this field, it is set to zero.

serialNr (String)

Serial number of the configuration item.

serviceId (ID)

Which service instance(s) the configuration item is, or will be, a part of. When creating a new CI and a value is not specified for this field, it is set to the service of the CI's product.

serviceInstanceIds ([ID!])

Identifiers of the service instances of this configuration item.

siteId (ID)

Where the CI is located, if it concerns a hardware CI.

siteLicense (Boolean)

true for license certificates that may only be used at one or more specific locations.

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

startDate (ISO8601Date)

The date on which the expense for the configuration item (CI) was incurred or, if the CI is depreciated over time, the date on which the depreciation was started. This is typically the invoice date.

status (CiStatus!)

The appropriate status for the configuration item (CI).

supplierId (ID)

Identifier of the supplier from which the configuration item (CI) has been obtained. When creating a new CI and a value is not specified for this field, it is set to the supplier of the CI's product.

supportTeamId (ID)

Identifier of the team responsible for supporting the configuration item and maintaining its information in the configuration management database (CMDB). When creating a new CI and a value is not specified for this field, it is set to the support team of the CI's product. Optional when status of CI equals "Removed", required otherwise.

systemID (String)

System identifier of the configuration item.

temporaryLicense (Boolean)

true for license certificates that are not valid indefinitely.

usefulLife (Int)

The number of years within which the configuration item is to be depreciated. When creating a new CI and a value is not specified for this field, it is set to the useful life of the CI's product.

userIds ([ID!])

Identifiers of the users of this configuration item.

warrantyExpiryDate (ISO8601Date)

The date through which the warranty coverage for the configuration item is valid. The warranty expires at the end of this day.

Return fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

configurationItem (ConfigurationItem)

Record after mutation.

errors ([ValidationError!])

Errors encountered during the mutation.