Creates a new dashboard from provided data
curl --request POST \
--url https://api.rootly.com/v1/dashboards \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "dashboards",
"attributes": {
"name": "<string>",
"owner": "user",
"description": "<string>",
"public": true,
"range": "<string>",
"auto_refresh": true,
"color": "#FCF2CF",
"icon": "<string>",
"period": "day"
}
}
}
'{
"data": {
"id": "040f6333-7328-435a-bbf9-5006c4d80d0b",
"type": "dashboards",
"attributes": {
"team_id": 156,
"user_id": 127,
"name": "Test dashboard",
"description": null,
"slug": "test-dashboard",
"public": false,
"owner": "user",
"range": "Last 30 Days",
"period": "day",
"color": "#FAE6E8",
"icon": "📊",
"auto_refresh": false,
"updated_at": "2025-12-07T22:30:38.594-08:00",
"created_at": "2025-12-07T22:30:38.594-08:00"
},
"relationships": {
"panels": {
"data": []
}
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
dashboards Show child attributes
The name of the dashboard
The owner type of the dashboard
user, team The description of the dashboard
Whether the dashboard is public
The date range for dashboard panel data
Whether the dashboard auto-updates the UI with new data.
The hex color of the dashboard
#FCF2CF, #D7F5E1, #E9E2FF, #FAE6E8, #FAEEE6 The emoji icon of the dashboard
The grouping period for dashboard panel data
day, week, month dashboard created
Show child attributes
Unique ID of the dashboard
dashboards Show child attributes
The name of the dashboard
The owner type of the dashboard
user, team Whether the dashboard is public
The dashboard team
The dashboard user owner if owner is of type user
The description of the dashboard
The date range for dashboard panel data
The grouping period for dashboard panel data
Whether the dashboard auto-updates the UI with new data.
The hex color of the dashboard
#FCF2CF, #D7F5E1, #E9E2FF, #FAE6E8, #FAEEE6 The emoji icon of the dashboard
Date of creation
Date of last update
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/dashboards \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "dashboards",
"attributes": {
"name": "<string>",
"owner": "user",
"description": "<string>",
"public": true,
"range": "<string>",
"auto_refresh": true,
"color": "#FCF2CF",
"icon": "<string>",
"period": "day"
}
}
}
'{
"data": {
"id": "040f6333-7328-435a-bbf9-5006c4d80d0b",
"type": "dashboards",
"attributes": {
"team_id": 156,
"user_id": 127,
"name": "Test dashboard",
"description": null,
"slug": "test-dashboard",
"public": false,
"owner": "user",
"range": "Last 30 Days",
"period": "day",
"color": "#FAE6E8",
"icon": "📊",
"auto_refresh": false,
"updated_at": "2025-12-07T22:30:38.594-08:00",
"created_at": "2025-12-07T22:30:38.594-08:00"
},
"relationships": {
"panels": {
"data": []
}
}
}
}