Returns a mapping from legacy custom report IDs to the new report IDs created by the report migration. Use this to update automations or integrations that still reference legacy report IDs. Pass a newReportId to Get Report by ID (get-report-by-id) to execute the migrated report.

Administrators receive a mapping for every custom report in the account; other users receive mappings only for the custom reports they can access (reports they own or that are shared with them). Because the map for a non-administrator is silently limited to their accessible reports, a legacy ID that is absent may be outside that user's visibility rather than nonexistent in the account.

Each entry pairs a legacyReportId with its newReportId and a status. When a report has not been migrated, newReportId is null and status is notMigrated; otherwise newReportId is the migrated report's ID and status is migrated.

Returns an empty mappings array when the user has no accessible custom reports.

OAuth Scopes: report