diff --git a/reference/devices.v1.yaml b/reference/devices.v1.yaml
index 8e3ee0f..399eac3 100644
--- a/reference/devices.v1.yaml
+++ b/reference/devices.v1.yaml
@@ -13,7 +13,18 @@ info:
     url: 'https://opensource.org/licenses/MIT'
 servers:
   - url: 'http://localhost:3000'
-paths: {}
+paths:
+  /api/devices:
+    get:
+      summary: getDevices
+      tags: []
+      responses: {}
+      operationId: get-api-devices
+    post:
+      summary: newDevice
+      tags: []
+      responses: {}
+      operationId: post-api-devices
 components:
   schemas: {}
   parameters:
@@ -24,7 +35,7 @@ components:
       name: accountid
       in: path
       required: true
-      description: unique per account (see `'My Account'` for more information)
+      description: "unique per account (see `'My Account'` for more information)"
     spaceid:
       schema:
         type: string
@@ -32,7 +43,7 @@ components:
         default: all
       in: query
       name: spaceid
-      description: location associated with the devices (see `'My Spaces'` for more information)
+      description: "location associated with the devices (see `'My Spaces'` for more information)"
       allowEmptyValue: true
     deviceName:
       schema:
@@ -41,7 +52,7 @@ components:
         example: garageCamera
       in: header
       name: deviceName
-      description: devices in the same space require unique names or will be assigned the default name `'newDevice'`
+      description: "devices in the same space require unique names or will be assigned the default name `'newDevice'`"
       allowEmptyValue: true
     deviceid:
       schema:
@@ -50,7 +61,7 @@ components:
         example: 123abc
       in: header
       name: deviceid
-      description: 'unique identifiers for devices registered on the service cloud, when empty it defaults to `''all''`'
+      description: "unique identifiers for devices registered on the service cloud, when empty it defaults to `'all'`"
       allowEmptyValue: true
       required: true
     sort: