---
schema_version: "1"
id: 4e9e211575c5a06952e603da7ff39560fae85aa65cc3da560bdc09f244cc5b20
title: Save a Dashboard
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/api_analytics/guides/examples/dashboards/analytics-api-dashboard-save-dashboard.md
canonical_url: https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-dashboard-save-dashboard.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: fbd333065def1b3caf6294da455f18d6f54c13471553b155c3d98cd217afa7e5
products:
  - Salesforce Reports and Dashboards REST API Developer Guide
  - analytics
---

# Save a Dashboard

You can save changes to a dashboard by sending a PATCH request to the Dashboard Results resource.

Use a PATCH request on the [Dashboard Results](https://developer.salesforce.com/docs/analytics/reference/dashboard/analytics-api-dashboard-results-resource.md) resource to save changes to a dashboard.

## Example Usage

```nolang
/services/data/v31.0/analytics/dashboards/01ZD00000007S89MAE
```

## Example Request Body

```nolang
{
  "dashboardMetadata" : {
    "name" : "Sales Dashboard",
  }
}
```

## Example Response Body

```nolang
{
  "componentData" : [ {
    "componentId" : "01aD0000000a36LIAQ",
    "reportResult" : {
      "attributes" : null,
      "allData" : true,
      "factMap" : {
        "T!T" : {
          "aggregates" : [ {
            "label" : "USD 67,043,365.50",
            "value" : 67043365.50166918337345123291015625
          } ]
        },
        "0!T" : {
          "aggregates" : [ {
            "label" : "USD 10,083.33",
            "value" : 10083.333333333333939663134515285491943359375
          } ]
        },
        "1!T" : {
          "aggregates" : [ {
            "label" : "USD 25,016,768.67",
            "value" : 25016768.670066006481647491455078125
          } ]
        },
        "2!T" : {
          "aggregates" : [ {
            "label" : "USD 42,016,513.50",
            "value" : 42016513.49826984107494354248046875
          } ]
        }
      },
      "groupingsAcross" : null,
      "groupingsDown" : {
        "groupings" : [ {
          "groupings" : [ ],
          "key" : "0",
          "label" : "-",
          "value" : null
        }, {
          "groupings" : [ ],
          "key" : "1",
          "label" : "Existing Business",
          "value" : "Existing Business"
        }, {
          "groupings" : [ ],
          "key" : "2",
          "label" : "New Business",
          "value" : "New Business"
        } ]
      },
      "hasDetailRows" : false,
      "reportExtendedMetadata" : {
        "aggregateColumnInfo" : {
          "s!AMOUNT" : {
            "acrossGroupingContext" : null,
            "dataType" : "currency",
            "downGroupingContext" : null,
            "label" : "Sum of Amount"
          }
        },
        "detailColumnInfo" : { },
        "groupingColumnInfo" : {
          "TYPE" : {
            "dataType" : "picklist",
            "groupingLevel" : 0,
            "label" : "Type"
          }
        }
      },
      "reportMetadata" : {
        "aggregates" : [ "s!AMOUNT" ],
        "chart" : null,
        "currency" : "USD",
        "description" : null,
        "detailColumns" : [ ],
        "developerName" : "Simple_Test",
        "division" : null,         
        "folderId" : "00lR0000000M8IiIAK",
        "groupingsAcross" : [ ],
        "groupingsDown" : [ {
          "dateGranularity" : "None",
          "name" : "TYPE",
          "sortAggregate" : null,
          "sortOrder" : "Asc"
        } ],
        "hasDetailRows" : false,         
        "hasRecordCount" : true,
        "historicalSnapshotDates" : [ ],
        "id" : "00OD0000001g2nWMAQ",
        "name" : "Simple Test",
        "reportBooleanFilter" : null,
        "reportFilters" : [ ],
        "reportFormat" : "SUMMARY",
        "reportType" : {
          "label" : "Opportunities",
          "type" : "Opportunity"
        },
        "scope" : "organization",         
        "showGrandTotal" : true,         
        "showSubtotals" : true,         
        "sortBy" : [ ],         
        "standardDateFilter" : { "column" : "CLOSE_DATE", "durationValue" : "CUSTOM", "endDate" : null, "startDate" : null },
        "standardFilters" : [ 
          { "name" : "open", "value" : "all" }, 
          { "name" : "probability", "value" : ">0" } ]
      }
    },
    "status" : {
      "dataStatus" : "DATA",
      "errorCode" : null,
      "errorMessage" : null,
      "errorSeverity" : null,
      "refreshDate" : "2014-04-09T00:28:16.000+0000",
      "refreshStatus" : "IDLE"
    }
  } ],
  "dashboardMetadata" : {
    "attributes" : {
      "dashboardId" : "01ZD00000007S89MAE",
      "dashboardName" : "Service Dept Dashboard",
      "statusUrl" : "/services/data/v31.0/analytics/dashboards/01ZD00000007S89MAE/status",
      "type" : "Dashboard"
    },
    "canChangeRunningUser" : false,
    "components" : [ {
      "componentData" : 0,
      "footer" : null,
      "header" : null,
      "id" : "01aD0000000a36LIAQ",
      "properties" : {
        "aggregates" : [ { "name" : "s!AMOUNT" } ],
        "autoSelectColumns" : false,         
        "groupings" : null,
        "maxRows" : null,
        "sort" : { "column" : "TYPE", "sortOrder" : "asc" },
        "useReportChart" : false,
        "visualizationProperties" : { 
          "breakPoints" : [ {             
            "aggregateName" : "s!AMOUNT",             
            "breaks" : [ 
              { "color" : "000000", "lowerBound" : null, "upperBound" : -1 }, 
              { "color" : "000000", "lowerBound" : -1, "upperBound" : 0 }, 
              { "color" : "000000", "lowerBound" : 0, "upperBound" : null } ]           
            } ],           
            "metricLabel" : null },         
          "visualizationType" : "Metric" },
      "reportId" : "00OD0000001g2nWMAQ",
      "title" : null,
      "type" : "Report"
    } ],
    "description" : null,
    "developerName" : "Simple_Dashboard",
    "filters" : [ {
      "name" : "Amount",
      "options" : [ {
        "alias" : null,
        "endValue" : null,
        "id" : "0ICD00000004CBiOAM",
        "operation" : "greaterThan",
        "startValue" : null,
        "value" : "USD 2000000"
      } ],
      "selectedOption" : null
    } ],
    "folderId" : "00lR0000000DrojIAC",
    "id" : "01ZD00000007S89MAE",
    "layout" : {
      "columns" : [ {
        "components" : [ 0 ]
      } ]
    },
    "name" : "Simple Dashboard",
    "runningUser" : {
      "displayName" : "Allison Wheeler",
      "id" : "005D00000016V2qIAE"
    }
  }
}
```