1 files changed, 16 insertions, 2 deletions
diff --git a/lib/api/entities/commit_status.rb b/lib/api/entities/commit_status.rb
index 61b8bf89cfe..df6a41895ff 100644
--- a/lib/api/entities/commit_status.rb
+++ b/lib/api/entities/commit_status.rb
@@ -3,8 +3,22 @@
 module API
   module Entities
     class CommitStatus < Grape::Entity
-      expose :id, :sha, :ref, :status, :name, :target_url, :description,
-             :created_at, :started_at, :finished_at, :allow_failure, :coverage
+      expose :id, documentation: { type: 'integer', example: 93 }
+      expose :sha, documentation: { type: 'string', example: '18f3e63d05582537db6d183d9d557be09e1f90c8' }
+      expose :ref, documentation: { type: 'string', example: 'develop' }
+      expose :status, documentation: { type: 'string', example: 'success' }
+      expose :name, documentation: { type: 'string', example: 'default' }
+      expose :target_url, documentation: {
+        type: 'string',
+        example: 'https://gitlab.example.com/janedoe/gitlab-foss/builds/91'
+      }
+      expose :description, documentation: { type: 'string' }
+      expose :created_at, documentation: { type: 'dateTime', example: '2016-01-19T09:05:50.355Z' }
+      expose :started_at, documentation: { type: 'dateTime', example: '2016-01-20T08:40:25.832Z' }
+      expose :finished_at, documentation: { type: 'dateTime', example: '2016-01-21T08:40:25.832Z' }
+      expose :allow_failure, documentation: { type: 'boolean', example: false }
+      expose :coverage, documentation: { type: 'number', format: 'float', example: 98.29 }
+
       expose :author, using: Entities::UserBasic
     end
   end