added openapi documentation

public/openapi/write.yaml

@@ -186,6 +186,8 @@ paths:
     $ref: 'write/posts/pid/upvoters.yaml'
   /posts/{pid}/bookmark:
     $ref: 'write/posts/pid/bookmark.yaml'
+  /posts/{pid}/verify:
+      $ref: 'write/posts/pid/verify.yaml'
   /posts/{pid}/diffs:
     $ref: 'write/posts/pid/diffs.yaml'
   /posts/{pid}/diffs/{since}:
@@ -261,4 +263,4 @@ paths:
   /files/:
     $ref: 'write/files.yaml'
   /files/folder:
-    $ref: 'write/files/folder.yaml'
+    $ref: 'write/files/folder.yaml'

public/openapi/write/posts/pid/verify.yaml

@@ -0,0 +1,26 @@
+put:
+  tags:
+    - posts
+  summary: verifies a post
+  description: This operation verifies a post.
+  parameters:
+    - in: path
+      name: pid
+      schema:
+        type: string
+      required: true
+      description: a valid post id
+      example: 2
+  responses:
+    '200':
+      description: Post successfully verified
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              status:
+                $ref: ../../../components/schemas/Status.yaml#/Status
+              response:
+                type: object
+                properties: {}