Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

MetadataComponentDependency (Beta)

Represents dependency relationships between the metadata components in your org. You can query MetadataComponentDependency using Tooling API in API version 43.0 and later or using Bulk API 2.0 in API 49.0 and later.

As a Beta feature, MetadataComponentDependency (Dependency API) is a preview and isn’t part of the “Services” under your Main Services Agreement with Salesforce. Use this feature at your sole discretion, and make your purchase decisions based on the generally available products and features. Salesforce doesn’t guarantee general availability of this feature within any particular time frame or at all, and we can discontinue it at any time. This feature is for evaluation purposes only, not for production use. It’s offered as is and isn’t supported. Salesforce has no liability for any harm or damage arising out of the use of this feature. All restrictions, Salesforce reservation of rights, obligations concerning the Services, and terms for related Non-Salesforce Applications and Content apply equally to your use of this feature. You can provide feedback and suggestions in the Dependency API/Field Usage (Beta) Trailblazer Community group page.

Note

Supported SOAP Calls

query()

Supported REST HTTP Methods

Tooling API—GET

Bulk API 2.0—POST, GET, PATCH, DELETE

Limitations

Tooling API

No more than 2000 records in a single query.
Reports are not included in MetadataComponentDependency queries. Use Bulk API 2.0 for dependency relationships that include reports.

Bulk API 2.0

No more than 100,000 records in a single query.

The following SOQL queries are not supported in both Tooling API and Bulk API 2.0

SOQL ORDER BY clause
SOQL SELECT clause: count() function
SOQL queryMore()
SOQL WHERE clause: any type of filter with MetadataComponentName
SOQL WHERE clause: any type of filter with RefMetadataComponentName
SOQL WHERE clause: contains operators other than =, !=, AND, or OR
SOQL WHERE clause: filter by (RefMetadataComponentType = ‘StandardEntity’)
SOQL WHERE clause: use of the LIKE operator with either the MetadataComponentType field or the RefMetadataComponentType field
SOQL OFFSET clause

SOQL Limitations

SOSL Limitations

Fields

Field	Details
MetadataComponentId	Type string Properties Filter, Group, Nillable, Sort Description The ID of a metadata component that depends on another component. The component with the ID listed in the output as MetadataComponentId has a reference to the component with its ID listed as RefMetadataComponentId. MetadataComponentId is a string field that usually contains either an 18-character ID or a standard object name. Use 18-character IDs, not 15-character IDs, in your queries of this field.
MetadataComponentName	Type string Properties Filter, Group, Nillable, Sort Description The name of a metadata component that depends on another component. For example, `YourClass` for an Apex class or `yourField` (without the `__c` suffix) for a custom field. The component with the name listed in the output as MetadataComponentName has a reference to the component with its name listed as RefMetadataComponentName.
MetadataComponentNamespace	Type string Properties Filter, Group, Nillable, Sort Description The namespace of a metadata component that depends on another component. The component with the namespace listed in the output as MetadataComponentNamespace has a reference to the component with its namespace listed as RefMetadataComponentNamespace.
MetadataComponentType	Type string Properties Filter, Group, Nillable, Sort Description The type of a metadata component that depends on another component. The component with the type listed in the output as MetadataComponentType has a reference to the component with its type listed as RefMetadataComponentType.
RefMetadataComponentId	Type string Properties Filter, Group, Nillable, Sort Description The ID of a metadata component that another component depends on. The component with the ID listed in the output as RefMetadataComponentId is referenced by the component with its ID listed as MetadataComponentId. RefMetadataComponentId is a string field that usually contains either an 18-character ID or a standard object name. Use 18-character IDs, not 15-character IDs, in your queries of this field.
RefMetadataComponentName	Type string Properties Filter, Group, Nillable, Sort Description The name of a metadata component that another component depends on. For example, `YourClass` for an Apex class or `yourField` (without the `__c` suffix) for a custom field. The component with the name listed in the output as RefMetadataComponentName is referenced by the component with its name listed as MetadataComponentName.
RefMetadataComponentNamespace	Type string Properties Filter, Group, Nillable, Sort Description The namespace of a metadata component that another component depends on. The component with the namespace listed in the output as RefMetadataComponentNamespace is referenced by the component with its namespace listed as MetadataComponentNamespace.
RefMetadataComponentType	Type string Properties Filter, Group, Nillable, Sort Description The type of a metadata component that another component depends on. The component with the type listed in the output as RefMetadataComponentType is referenced by the component with its type listed as MetadataComponentType.