--- schema_version: "1" id: 507c906f43027e43afe285801686adadf57fe06b5aed93409282d95d3e04b963 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/260-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=260&type=5 source_site: help.salesforce.com content_type: documentation content_hash: fc97b979359a4e7fb9d23e606a73761efccafe7436ee9d6adf25d731b0caca09 description: Use the GraphQL API to query, search, and manage configuration items in the Agentforce IT Service configuration management database (CMDB). products: - Cross Cloud Packages Solutions release: "260" --- # 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). Query a configuration item by its unique identifier Make a POST request to the `/service/itsm/v1/cmdb/graphql` resource using the `ciById` 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 `/service/itsm/v1/cmdb/graphql` resource using the `searchCI` 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 `/service/itsm/v1/cmdb/graphql` resource using the `getStatus` 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 `/service/itsm/v1/cmdb/graphql` resource using the `upsertCI` mutation. New request body: Upsert Configuration Items Input New response body: Upsert Configuration Items Output Specify parent and relationship details when upserting configuration items Use the new `parentCiId` and `relationshipType` fields in the `payload` of the `upsertCI` mutation. Delete a configuration item by its unique identifier Make a POST request to the `/service/itsm/v1/cmdb/graphql` resource using the `deleteCI` 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 `/service/itsm/v1/cmdb/graphql` resource using the `deleteCIRelationship` 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 `/service/itsm/v1/cmdb/graphql` resource using the `updateCIById` 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 `/service/itsm/v1/cmdb/graphql` resource using the `upsertCIRelationship` 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 `/service/itsm/v1/cmdb/graphql` resource using the `getComponentsByCiId` 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 `/service/itsm/v1/cmdb/graphql` resource using the `getCIHistory` 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 `/service/itsm/v1/cmdb/graphql` resource using the `getCIRelationships` query. New request body: Get Configuration Item Relationship Input New response body: Get Configuration Item Relationship Output Find configuration items with more precise search filters Use the new filter operator values in the existing `operator` field for `searchCI` query. Filter configuration items by creation or last modified date Use the new `created_at` and `updated_at` values added in the existing `field` for `searchCI` query. Sort configuration items by creation or last modified date Use the new `created_at` and `updated_at` values added in the existing `sortKey` field for `searchCI` query. Get discovery information when querying a configuration item by ID Use the new `discoveryInformation` in the existing `ciById` query response. Authenticate to the CMDB GraphQL API using user sign-in Use the new User-Interactive OAuth 2.0 Flow. #### See Also - [_Agentforce IT Service Developer Guide: GraphQL APIs:_ Operation Types](https://developer.salesforce.com/docs/atlas.en-us.agentforce_it_service_dev_guide.meta/agentforce_it_service_dev_guide/graphql_types.htm) - [_Agentforce IT Service Developer Guide: GraphQL APIs:_ Authorization: Integration User](https://developer.salesforce.com/docs/atlas.en-us.agentforce_it_service_dev_guide.meta/agentforce_it_service_dev_guide/graphql_api_authentication.htm) - [_Agentforce IT Service Developer Guide: GraphQL APIs:_ Authorization: User Sign-In](https://developer.salesforce.com/docs/atlas.en-us.agentforce_it_service_dev_guide.meta/agentforce_it_service_dev_guide/graphql_api_authentication_user_interactive_oauth.htm)