1 files changed, 5 insertions, 3 deletions
diff --git a/lib/api/entities/snippet.rb b/lib/api/entities/snippet.rb
index af885aaf0eb..709566944ed 100644
--- a/lib/api/entities/snippet.rb
+++ b/lib/api/entities/snippet.rb
@@ -3,11 +3,13 @@
 module API
   module Entities
     class Snippet < BasicSnippet
-      expose :author, using: Entities::UserBasic
-      expose :file_name do |snippet|
+      expose :author, using: Entities::UserBasic, documentation: { type: 'Entities::UserBasic' }
+      expose :file_name, documentation: { type: 'string', example: 'add.rb' } do |snippet|
         snippet_files.first || snippet.file_name
       end
-      expose :files do |snippet, options|
+      expose :files, documentation: {
+        is_array: true, example: 'e0d123e5f316bef78bfdf5a008837577'
+      } do |snippet, options|
         snippet_files.map do |file|
           {
             path: file,