Update a single dashboard

PUT /dashboards/{id}

cURL

cURL

curl -X PUT https://api.growthbook.io/api/v1/dashboards/{id} -d '{ ... }' -u secret_abc123DEF456

200

{
  "dashboard": {
    "id": "<string>",
    "uid": "<string>",
    "organization": "<string>",
    "isDefault": true,
    "isDeleted": true,
    "userId": "<string>",
    "editLevel": "published",
    "shareLevel": "published",
    "enableAutoUpdates": true,
    "title": "<string>",
    "dateCreated": "2023-11-07T05:31:56Z",
    "dateUpdated": "2023-11-07T05:31:56Z",
    "blocks": [
      {
        "organization": "<string>",
        "id": "<string>",
        "uid": "<string>",
        "type": "<string>",
        "title": "<string>",
        "description": "<string>",
        "factMetricId": "<string>",
        "visualizationType": "histogram",
        "valueType": "avg",
        "metricAnalysisId": "<string>",
        "analysisSettings": {
          "userIdType": "<string>",
          "lookbackDays": 123,
          "populationType": "metric",
          "populationId": "<string>",
          "startDate": "<string>",
          "endDate": "<string>",
          "additionalNumeratorFilters": [
            "<string>"
          ],
          "additionalDenominatorFilters": [
            "<string>"
          ]
        },
        "snapshotId": "<string>"
      }
    ],
    "experimentId": "<string>",
    "updateSchedule": {
      "type": "<string>",
      "hours": 123
    },
    "projects": [
      "<string>"
    ],
    "nextUpdate": "2023-11-07T05:31:56Z",
    "lastUpdated": "2023-11-07T05:31:56Z"
  }
}

Authorizations

bearerAuthbasicAuth

Authorization · string · header · required

If using Bearer auth, pass the Secret Key as the token:

curl https://api.growthbook.io/api/v1 \
  -H "Authorization: Bearer secret_abc123DEF456"

Path Parameters

id · string · required

Body

application/json

title · string

The display name of the Dashboard

editLevel · enum<string>

Dashboards that are "published" are editable by organization members with appropriate permissions

Available options: published, private

shareLevel · enum<string>

General Dashboards only. Dashboards that are "published" are viewable by organization members with appropriate permissions

Available options: published, private

enableAutoUpdates · boolean

If enabled for a General Dashboard, also requires an updateSchedule

updateSchedule · object

General Dashboards only. Experiment Dashboards update based on the parent experiment instead

Option 1

Option 2

Show child attributes

projects · string[]

General Dashboards only, Experiment Dashboards use the experiment's projects

blocks · object[]

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Show child attributes

Response

200 - application/json

Success

dashboard · object · required

Show child attributes