Salesforce Reports and Dashboards REST API Developer Guide
Summer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Summer '15 (API version 34.0)
Spring '15 (API version 33.0)
Winter '15 (API version 32.0)
Spring '14 (API version 30.0)
Get List of Recently Used Dashboards
Get Dashboard Results
Filter Dashboard Results
Get Dashboard Status
Refresh a Dashboard
Save a Dashboard
Set a Sticky Dashboard Filter
Return Details About Dashboard Components
Get Dashboard Metadata
Clone a Dashboard
Delete a Dashboard
Newer Version Available
Dashboards Examples
Learn how to refresh, create, edit, copy, and delete dashboards.
-
Get List of Recently Used Dashboards
You can get a list of recently used dashboards by using the Dashboard resource. -
Get Dashboard Results
You can get dashboard metadata, data, and status by sending a GET request to the Dashboard Results resource. -
Filter Dashboard Results
You can filter dashboard results, status, or refresh requests, by using filter parameters. -
Get Dashboard Status
You can get the dashboard status by sending a GET request to the Dashboard Status resource. -
Refresh a Dashboard
You can refresh a dashboard by using a PUT Dashboard Results request. Dynamic dashboards can also be refreshed via the REST API. -
Save a Dashboard
You can save changes to a dashboard by sending a PATCH request to the Dashboard Results resource. -
Set a Sticky Dashboard Filter
Set a default filter value which gets applied to a dashboard when you open it. The default filter value you specify only applies to you (other people won’t see it when they open the dashboard). If you change the filter value while viewing the dashboard, then the filter value you set in the user interface overwrites the value you set via the API. To set sticky filters for a dashboard, canUseStickyFilter must equal true. -
Return Details About Dashboard Components
Get details about one or more dashboard components using a POST request. -
Get Dashboard Metadata
Get details about dashboard metadata using a GET request. -
Clone a Dashboard
Creates a copy of a dashboard by sending a POST request to the Dashboard List resource. -
Delete a Dashboard