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

2.6 KiB

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

User-starred metrics dashboards API (FREE)

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 are 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
}