---
schema_version: "1"
id: 929fc27dc88d71b85975abd09c9b20889c623032484618fd03fa46bc4eca84dc
title: New and Changed GraphQL APIs in Configuration Management Database
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/release-notes/262-0-0/rn_it_service_cmdb_graphql_api_resources.md
canonical_url: https://help.salesforce.com/s/articleView?id=release-notes.rn_it_service_cmdb_graphql_api_resources.htm&release=262.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: ec7ffc0308432668054e8f1fa77a13bee752c3c382306f47bb1e2a9267da2c40
description: Use the GraphQL API to query, search, and manage configuration items in the Agentforce IT Service configuration management database (CMDB).
products:
  - Cross Cloud
release: "262"
---
# New and Changed GraphQL APIs in Configuration Management Database

Use the GraphQL API to query, search, and manage configuration items in the Agentforce IT Service configuration management database (CMDB).

## GraphQL V2 API

Query a configuration item by its unique identifier

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `getConfigurationItemById` query.

New request body: Query Configuration Item by ID Input

New response body: Query Configuration Item by ID Output

Search configuration items with pagination, filtering, and sorting

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `searchConfigurationItems` query.

New request body: Search Configuration Item Input

New response body: Search Configuration Item Output

Retrieve the status of a previously submitted asynchronous job

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `getOperationStatus` query.

New request body: Get Status of Operation Input

New response body: Get Status of Operation Output

Create or update configuration items in bulk

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `upsertConfigurationItems` mutation.

New request body: Upsert Configuration Items Input

New response body: Upsert Configuration Items Output

Delete a configuration item by its unique identifier

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `deleteConfigurationItem` mutation.

New request body: Delete Configuration Item Input

New response body: Delete Configuration Item Output

Delete a configuration item relationship by its unique identifier

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `deleteCnfgItemRelationship` mutation.

New request body: Delete Configuration Item Relationship Input

New response body: Delete Configuration Item Relationship Output

Update one or more attributes of an existing configuration item by its unique identifier

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `updateConfigurationItemById` mutation.

New request body: Update Configuration Item by ID Input

New response body: Update Configuration Item by ID Output

Create or update configuration item relationships in bulk

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `upsertCnfgItemRelationships` mutation.

New request body: Upsert Configuration Item Relationship Input

New response body: Upsert Configuration Item Relationship Output

Get child components of a configuration item by unique identifier and component type

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `getComponentsByCnfgItemId` query.

New request body: Get Components Input

New response body: Get Components Output

Retrieve the audit trail of changes for a configuration item

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `getConfigurationItemHistory` query.

New request body: Get Configuration Item History Input

New response body: Get Configuration Item History Output

Retrieve detailed relationship information for a configuration item

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `getCnfgItemRelationships` query.

New request body: Get Configuration Item Relationship Input

New response body: Get Configuration Item Relationship Output

Search components for configuration items with pagination, filtering, and sorting

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `searchComponentCnfgItems` query.

New request body: Search Component Configuration Item Input

New response body: Search Component Configuration Item Output

Retrieve tags associated with a configuration item

Make a POST request to the new `/service/itsm/v2/cmdb/graphql` resource using the `getAllConfigurationItemTags` query.

New request body: Get All Tags Input

New response body: Get All Tags Output

## GraphQL V1 API

Search components for configuration items with pagination, filtering, and sorting

Make a POST request to the existing `/service/itsm/v1/cmdb/graphql` resource using the new `searchComponentCnfgItems` query.

New request body: Search Component Configuration Item Input

New response body: Search Component Configuration Item Output

Retrieve tags associated with a configuration item

Make a POST request to the existing `/service/itsm/v1/cmdb/graphql` resource using the new `getAllConfigurationItemTags` query.

New request body: Get All Tags Input

New response body: Get All Tags Output

#### See Also

- [_Agentforce IT Service Developer Guide_: Configuration Management Database GraphQL APIs](https://developer.salesforce.com/docs/atlas.en-us.agentforce_it_service_dev_guide.meta/agentforce_it_service_dev_guide/agentforce_it_service_graphql_apis_parent.htm)