1 files changed, 10 insertions, 7 deletions
diff --git a/lib/api/entities/x509_certificate.rb b/lib/api/entities/x509_certificate.rb
index aad11339148..95d4948906e 100644
--- a/lib/api/entities/x509_certificate.rb
+++ b/lib/api/entities/x509_certificate.rb
@@ -3,13 +3,16 @@
 module API
   module Entities
     class X509Certificate < Grape::Entity
-      expose :id
-      expose :subject
-      expose :subject_key_identifier
-      expose :email
-      expose :serial_number
-      expose :certificate_status
-      expose :x509_issuer, using: 'API::Entities::X509Issuer'
+      expose :id, documentation: { type: 'integer', example: 1 }
+      expose :subject, documentation: { type: 'string', example: 'CN=gitlab@example.org,OU=Example,O=World' }
+      expose :subject_key_identifier, documentation: {
+        type: 'string',
+        example: 'BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC'
+      }
+      expose :email, documentation: { type: 'string', example: 'gitlab@example.org' }
+      expose :serial_number, documentation: { type: 'integer', example: 278969561018901340486471282831158785578 }
+      expose :certificate_status, documentation: { type: 'string', example: 'good' }
+      expose :x509_issuer, using: 'API::Entities::X509Issuer', documentation: { type: 'string', example: '100755' }
     end
   end
 end