Mirror of <https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-v1-insight-metadata.html> (Salesforce, Data 360 Query Guide), read 2026-10-23. Salesforce's own page is the authority; this copy exists because that site refuses non-browser readers.

Retrieves metadata for all available calculated insights in your Data 360 instance. This endpoint returns detailed information about dimensions, measures, and relationships for each calculated insight.

HTTP Method: GET
Availability: Data 360 v1.0, Salesforce v51.0
Format: REST
URI: /api/v1/insight/metadata

The response includes an array of metadata objects, each containing:

name: The unique identifier of the calculated insight
displayName: The human-readable name of the calculated insight
dimensions: Array of dimension objects with name, displayName, and type
measures: Array of measure objects with name, displayName, type, and rollupable flag
relationships: Array of relationship objects showing connections between entities
partitionBy: The field used for partitioning the data

The response includes all calculated insights available to the authenticated user
Each insight’s metadata includes all available dimensions and measures
Relationship information helps understand data connections between different entities
The partitionBy field indicates how the data is organized for efficient querying