1 files changed, 14 insertions, 6 deletions
diff --git a/lib/api/entities/releases/link.rb b/lib/api/entities/releases/link.rb
index 5157645af69..abf380e11d5 100644
--- a/lib/api/entities/releases/link.rb
+++ b/lib/api/entities/releases/link.rb
@@ -4,14 +4,22 @@ module API
   module Entities
     module Releases
       class Link < Grape::Entity
-        expose :id
-        expose :name
-        expose :url
-        expose :direct_asset_url do |link|
+        expose :id, documentation: { type: 'integer', example: 1 }
+        expose :name, documentation: { type: 'string', example: 'app-v1.0.dmg' }
+        expose :url, documentation:
+          {
+            type: 'string',
+            example: 'https://gitlab.example.com/root/app/-/jobs/688/artifacts/raw/bin/app-v1.0.dmg'
+          }
+        expose :direct_asset_url, documentation:
+          {
+            type: 'string',
+            example: 'https://gitlab.example.com/root/app/-/releases/v1.0/downloads/app-v1.0.dmg'
+          } do |link|
           ::Releases::LinkPresenter.new(link).direct_asset_url
         end
-        expose :external?, as: :external
-        expose :link_type
+        expose :external?, documentation: { type: 'boolean' }, as: :external
+        expose :link_type, documentation: { type: 'string', example: 'other' }
       end
     end
   end