gitlab-org--gitlab-foss/doc/api/metrics_user_starred_dashboards.md

stage	group	info	type
Monitor	APM	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers	concepts, howto

User-starred metrics dashboards API

The starred dashboard feature makes navigating to frequently-used dashboards easier by displaying favorited dashboards at the top of the select list.

Add a star to a dashboard

• Introduced in GitLab 13.0.

POST /projects/:id/metrics/user_starred_dashboards

Parameters:

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project
dashboard_path	string	yes	URL-encoded path to file defining the dashboard which should be marked as favorite.

curl --header 'Private-Token: <your_access_token>' https://gitlab.example.com/api/v4/projects/20/metrics/user_starred_dashboards \
 --data-urlencode "dashboard_path=config/prometheus/dashboards/common_metrics.yml"

Example Response:

{
  "id": 5,
  "dashboard_path": "config/prometheus/common_metrics.yml",
  "user_id": 1,
  "project_id": 20
}

Remove a star from a dashboard

• Introduced in GitLab 13.0.

DELETE /projects/:id/metrics/user_starred_dashboards

Parameters:

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project
dashboard_path	string	no	URL-encoded path to file defining the dashboard which should no longer be marked as favorite. When not supplied all dashboards within given projects will be removed from favorites.

curl --request DELETE --header 'Private-Token: <your_access_token>' https://gitlab.example.com/api/v4/projects/20/metrics/user_starred_dashboards \
 --data-urlencode "dashboard_path=config/prometheus/dashboards/common_metrics.yml"

Example Response:

{
  "deleted_rows": 1
}