Update Configuration Item

Updates one or more attributes of an existing configuration item specified by its unique identifier. You can 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

Request

JSON example

1mutation UpdateCIById {
2  updateCIById(
3    input: {
4      SD_AsNa: "abc"
5      SD_SeIpAd: "10.10.10.10"
6      id: "6249301"
7    }
8  ) {
9    id
10    lastModifiedOn
11    updatedAttributes {
12      developerName
13      value
14    }
15  }
16}

Properties

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

Response

JSON example

1{
2  "data": {
3    "updateCIById": {
4      "id": 6249301,
5      "lastModifiedOn": "1764831587989",
6      "updatedAttributes": [
7        {
8          "developerName": "SD_AsNa",
9          "value": "abc"
10        },
11        {
12          "developerName": "SD_SeIpAd",
13          "value": "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.	66.0
`lastModifiedOn`	String	The date and time the record was last updated.	66.0
`updatedAttributes`	UpdatedAttributes	An array of objects containing the developer names and values of the attributes that were updated.	66.0

UpdatedAttributes

JSON example

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

1{
2  "updatedAttributes": [
3    {
4      "developerName": "SD_AsNa",
5      "value": "abc"
6    },
7    {
8      "developerName": "SD_SeIpAd",
9      "value": "10.10.10.10"
10    }
11  ]
12}

Properties

Name	Type	Description	Available Version
`developerName`	String	The developer name of the updated attribute.	66.0
`value`	String	The new value assigned to the attribute after the update operation.	66.0

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

Standard Attributes: Many attributes are available out-of-the-box.
Custom Attributes: You can 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