Salesforce Docs Portal

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