diff --git a/src/server/openapi.yaml b/src/server/openapi.yaml
index 3e3d3dc8831834ab9f8ee13b22e6ae7531771482..3106b614b35673fdc3ed1a6e209f9b6062285840 100644
--- a/src/server/openapi.yaml
+++ b/src/server/openapi.yaml
@@ -94,7 +94,7 @@ paths:
         name: resultClass
         schema: 
           type: string
-          example: perspective1
+          example: placesMsProduced
         required: true
         description: The class of the results
       requestBody:
@@ -210,12 +210,14 @@ paths:
           name: facetClass
           schema: 
             type: string
+            example: perspective1
           required: true
           description: The class of the facet
         - in: path
           name: id
           schema: 
             type: string
+            example: language
           required: true
           description: The id of the facet
       requestBody:
@@ -227,8 +229,10 @@ paths:
               properties:
                 sortBy:
                  type: string
+                 example: instanceCount
                 sortDirection:
                   type: string 
+                  example: desc
                 constraints:
                     type: array
                     items: 
@@ -273,12 +277,14 @@ paths:
           name: resultClass
           schema: 
             type: string
+            example: perspective1
           required: true
           description: The class of the resource
         - in: path
           name: uri
           schema: 
             type: string
+            example: http://ldf.fi/mmm/manifestation_singleton/bibale_10003
           required: true
           description: The URI of the resource
       requestBody:
@@ -545,14 +551,15 @@ paths:
             application/json:
               schema:
                 type: object
-  /void/{perspectiveID}:
+  /void/{resultClass}:
     get:
       summary: Retrieve a VoID description
       parameters:
         - in: path
-          name: perspectiveID
+          name: resultClass
           schema: 
             type: string
+            example: perspective1KnowledgeGraphMetadata
           required: true
       responses:
         '200':