swagger OK resopnse bodies

public/swagger/v1/entities/index.yaml

@@ -0,0 +1,44 @@
+paths:
+  summary: "Interact with all entities within a namespace"
+  get:
+    description: "Get names and IDs of all entities"
+    tags:
+    - entities
+    parameters:
+    - $ref: "#/components/parameters/token"
+    responses:
+      200:
+        content:
+          applicaiton/json:
+            schema:
+              type: array
+              items:
+                type: object
+                properties:
+                  Name: string
+                  ID: string
+                example:
+                  Name: John Smith
+                  ID: abc-123
+
+  post:
+    description: "Create a new entity"
+    tags:
+    - entities
+    parameters:
+    - $ref: "#/components/parameters/token"
+    requestBody:
+      $ref: "#/components/schemas/requestOne"
+    responses:
+      200:
+        $ref: "#/components/schemas/responseOne"
+
+components:
+  parameters:
+    token:
+      $ref: "../swagger.yaml#/components/parameters/token"
+  schemas:
+    requestOne:
+      $ref: "../swagger.yaml#/components/schemas/requestOne"
+    responseOne:
+      $ref: "../swagger.yaml#/components/schemas/responseOne"