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.
To update a configuration item, you must have the following user permissions:
- IT Service Configuration Item Type Manager
- IT Service Configuration Item Owner
| 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 |
| 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 |
An array of objects containing the developer names and values of the attributes that were updated in the configuration item.
| 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).