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).

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