diff --git a/doc/swagger.yml b/doc/swagger.yml
index d58442b2e..729d5c4c1 100644
--- a/doc/swagger.yml
+++ b/doc/swagger.yml
@@ -192,6 +192,38 @@ paths:
             Unable to update the Repository record in the database
 
 
+  #
+  # Repos Param Encryption Enpoint
+  # TODO: properly add the input output schema
+
+  /repos/{owner}/{name}/encrypt:
+    post:
+      parameters:
+        - name: owner
+          in: path
+          type: string
+          description: owner of the repository
+        - name: name
+          in: path
+          type: string
+          description: name of the repository
+      tags:
+        - Repos
+      summary: Encrypt
+      description: Creates encrypted environment variable strings.
+      security:
+        - accessToken: []
+      responses:
+        200:
+          description: The encrypted parameters.
+        400:
+          description: |
+            Unable to encrypt the parameters.
+        404:
+          description: |
+            Unable to find the repository.
+
+
   #
   # Repos Watch/Unwatch Enpoint
   #
@@ -992,6 +1024,16 @@ definitions:
       environment:
         type: object
   Activity:
+    example: |
+        {
+          "owner":"drone",
+          "name":"drone-test-go",
+          "full_name":"drone/drone-test-go",
+          "number": 1,
+          "status": "success",
+          "started_at": 5788800,
+          "finished_at": 5789500
+        }
     properties:
       owner:
         type: string