summaryrefslogtreecommitdiff
path: root/lib/api/metrics/user_starred_dashboards.rb
diff options
context:
space:
mode:
Diffstat (limited to 'lib/api/metrics/user_starred_dashboards.rb')
-rw-r--r--lib/api/metrics/user_starred_dashboards.rb22
1 files changed, 19 insertions, 3 deletions
diff --git a/lib/api/metrics/user_starred_dashboards.rb b/lib/api/metrics/user_starred_dashboards.rb
index 4d5396acccb..0a91e914d52 100644
--- a/lib/api/metrics/user_starred_dashboards.rb
+++ b/lib/api/metrics/user_starred_dashboards.rb
@@ -6,14 +6,22 @@ module API
feature_category :metrics
urgency :low
+ USER_STARRED_DASHBOARDS_TAGS = %w[user_starred_dashboards].freeze
+
resource :projects do
- desc 'Marks selected metrics dashboard as starred' do
+ desc 'Add a star to a dashboard' do
+ detail 'Marks selected metrics dashboard as starred. Introduced in GitLab 13.0.'
success Entities::Metrics::UserStarredDashboard
+ failure [
+ { code: 400, message: 'Bad request' },
+ { code: 404, message: 'Not found' }
+ ]
+ tags USER_STARRED_DASHBOARDS_TAGS
end
params do
requires :dashboard_path, type: String, allow_blank: false, coerce_with: ->(val) { CGI.unescape(val) },
- desc: 'Url encoded path to a file defining the dashboard to which the star should be added'
+ desc: 'URL-encoded path to file defining the dashboard which should be marked as favorite'
end
post ':id/metrics/user_starred_dashboards' do
@@ -26,7 +34,15 @@ module API
end
end
- desc 'Remove star from selected metrics dashboard'
+ desc 'Remove a star from a dashboard' do
+ detail 'Remove star from selected metrics dashboard. Introduced in GitLab 13.0.'
+ success code: 200
+ failure [
+ { code: 400, message: 'Bad request' },
+ { code: 404, message: 'Not found' }
+ ]
+ tags USER_STARRED_DASHBOARDS_TAGS
+ end
params do
optional :dashboard_path, type: String, allow_blank: false, coerce_with: ->(val) { CGI.unescape(val) },