Update Configuration Item

Update one or more attributes of an existing configuration item specified by its unique identifier. Update a subset of attributes or all attributes in a single request.

To update a configuration item, you must have the following user permissions:

  • IT Service Configuration Item Type Manager
  • IT Service Configuration Item Owner

See Also

NameTypeDescriptionRequired or OptionalAvailable Version
idIDThe unique identifier of the configuration item to update.Required67.0
attributeDeveloperNameStringThe developer name of the configuration item attribute to update. You can specify multiple attributes in a single request.Required67.0
NameTypeDescriptionAvailable Version
idIntegerThe unique integer identifier of the updated configuration item.67.0
lastModifiedOnStringThe date and time the record was last updated.67.0
modifiedAttributesModifiedAttributesAn array of objects containing the developer names and values of the attributes that were updated.67.0

An array of objects containing the developer names and values of the attributes that were updated in the configuration item.

NameTypeDescriptionAvailable Version
attributeDeveloperNameStringThe developer name of the updated attribute.67.0
modifiedValueStringThe new value assigned to the attribute after the update operation.67.0

When using the updateConfigurationItemById operation, you can update any available attribute using its Developer Name. The attributes you can update include:

  • Standard Attributes—Attributes are available out-of-the-box.
  • Custom Attributes—Create and include custom attributes using the sObject API.

Add any attribute using its Developer Name. For example, SD_AsNa—Asset Name to specify exactly which attributes you want to update for your Configuration Items (CIs).