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.

Special Access Rules

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

REST API Developer Guide: sObject Basic Information

Request

JSON example

1mutation UpdateConfigurationItemById {
2  updateConfigurationItemById(
3    input: {
4      SD_AsNa: "Office Printer"
5      SD_SeIpAd: "10.10.10.10"
6      id: "6249301"
7    }
8  ) {
9    id
10    lastModifiedOn
11    modifiedAttributes {
12      attributeDeveloperName
13      modifiedValue
14    }
15  }
16}

Properties

Name	Type	Description	Required or Optional	Available Version
`id`	ID	The unique identifier of the configuration item to update.	Required	67.0
`attributeDeveloperName`	String	The developer name of the configuration item attribute to update. You can specify multiple attributes in a single request.	Required	67.0

Response

JSON example

1{
2  "data": {
3    "UpdateConfigurationItemById": {
4      "id": 6249301,
5      "lastModifiedOn": "1764831587989",
6      "modifiedAttributes": [
7        {
8          "attributeDeveloperName": "SD_AsNa",
9          "modifiedValue": "abc"
10        },
11        {
12          "attributeDeveloperName": "SD_SeIpAd",
13          "modifiedValue": "10.10.10.10"
14        }
15      ]
16    }
17  }
18}

Properties

Name	Type	Description	Available Version
`id`	Integer	The unique integer identifier of the updated configuration item.	67.0
`lastModifiedOn`	String	The date and time the record was last updated.	67.0
`modifiedAttributes`	ModifiedAttributes	An array of objects containing the developer names and values of the attributes that were updated.	67.0

ModifiedAttributes

JSON example

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

1{
2  "modifiedAttributes": [
3    {
4      "attributeDeveloperName": "SD_AsNa",
5      "modifiedValue": "abc"
6    },
7    {
8      "attributeDeveloperName": "SD_SeIpAd",
9      "modifiedValue": "10.10.10.10"
10    }
11  ]
12}

Properties

Name	Type	Description	Available Version
`attributeDeveloperName`	String	The developer name of the updated attribute.	67.0
`modifiedValue`	String	The 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).

Note