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.