NOISSUE - Add missing fields to openapi specs and enclose http codes in single quotes (#1302)

* Add req body to token req

Signed-off-by: Darko Draskovic <darko.draskovic@gmail.com>

* Shorten summaries and add/remove keys

Signed-off-by: Darko Draskovic <darko.draskovic@gmail.com>

* Add single quotes to html response codes

Signed-off-by: Darko Draskovic <darko.draskovic@gmail.com>

authn/openapi.yml

@@ -16,15 +16,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/KeyRequest"
       responses:
-        201:
+        '201':
           description: Issued new key.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        409:
+        '409':
           description: Failed due to using already existing ID.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /keys/{id}:
     get:
@@ -38,13 +38,13 @@ paths:
       security:
       - Authorization: []
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/KeyRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     delete:
       summary: Revoke API key
@@ -57,11 +57,11 @@ paths:
       security:
       - Authorization: []
       responses:
-        204:
+        '204':
           description: Key revoked.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
 
 components:

bootstrap/openapi.yml

@@ -18,15 +18,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ConfigCreateReq"
       responses:
-        201:
+        '201':
           $ref: "#/components/responses/ConfigCreateRes"
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     get:
       summary: Retrieves managed configs
@@ -44,13 +44,13 @@ paths:
         - $ref: "#/components/parameters/State"
         - $ref: "#/components/parameters/Name"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ConfigListRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/configs/{configId}:
     get:
@@ -61,13 +61,13 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ConfigId"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ConfigRes"
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Config does not exist.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     put:
       summary: Updates config info
@@ -83,17 +83,17 @@ paths:
       requestBody:
           $ref: "#/components/requestBodies/ConfigUpdateReq"
       responses:
-        200:
+        '200':
           description: Config updated.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Config does not exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     delete:
       summary: Removes a Config
@@ -106,13 +106,13 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ConfigId"
       responses:
-        204:
+        '204':
           description: Config removed.
-        400:
+        '400':
           description: Failed due to malformed config ID.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/configs/certs/{configId}:
     patch:
@@ -128,17 +128,17 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ConfigCertUpdateReq"
       responses:
-        200:
+        '200':
           description: Config updated.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Config does not exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/configs/connections/{configId}:
     put:
@@ -154,17 +154,17 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ConfigConnUpdateReq"
       responses:
-        200:
+        '200':
           description: Config updated.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Config does not exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/bootstrap/{externalId}:
     get:
@@ -177,12 +177,12 @@ paths:
         - $ref: "#/components/parameters/ConfigAuth"
         - $ref: "#/components/parameters/ExternalId"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/BootstrapConfigRes"
-        404:
+        '404':
           description: |
             Failed to retrieve corresponding config.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/bootstrap/secure/{externalId}:
     get:
@@ -195,12 +195,12 @@ paths:
         - $ref: "#/components/parameters/EncConfigAuth"
         - $ref: "#/components/parameters/ExternalId"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/BootstrapConfigRes"
-        404:
+        '404':
           description: |
             Failed to retrieve corresponding config. 
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/state/{configId}:
     put:
@@ -216,13 +216,13 @@ paths:
       requestBody:
         $ref: '#/components/requestBodies/ConfigStateUpdateReq'
       responses:
-        204:
+        '204':
           description: Config removed.
-        400:
+        '400':
           description: Failed due to malformed config's ID.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
 
 components:

certs/openapi.yml

@@ -16,11 +16,11 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/CertReq"
       responses:
-        201:
+        '201':
           description: Created
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        500:
+        '500':
           description: Unexpected server-side error ocurred.
   /certs/{thingID}:
     get:
@@ -33,12 +33,12 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ThingID"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/CertsRes"
-        404:
+        '404':
           description: |
             Failed to retrieve corresponding certificate.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /certs/revoke:
     delete:
@@ -51,12 +51,12 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ThingID"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/RevokeRes"
-        404:
+        '404':
           description: |
             Failed to revoke corresponding certificate.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
 
 components:

http/openapi.yml

@@ -18,17 +18,17 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/MessageReq"
       responses:
-        202:
+        '202':
           description: Message is accepted for processing.
-        400:
+        '400':
           description: Message discarded due to its malformed content.
-        403:
+        '403':
           description: Message discarded due to missing or invalid credentials.
-        404:
+        '404':
           description: Message discarded due to invalid channel id.
-        415:
+        '415':
           description: Message discarded due to invalid or missing content type.
-        500:
+        '500':
           description: Unexpected server-side error occurred.
 
 components:
@@ -102,6 +102,7 @@ components:
       in: header
       schema:
         type: string
+        format: uuid
       required: true
     ID:
       name: id

provision/openapi.yml

@@ -16,13 +16,13 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ProvisionReq"
       responses:
-        201:
+        '201':
           description: Created
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        403:
+        '403':
           description: Unauthorized.
-        500:
+        '500':
           description: Unexpected server-side error ocurred.
     get:
       summary: Gets current mapping.
@@ -34,11 +34,11 @@ paths:
       parameters:
       - $ref: "#/components/parameters/Authorization"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ProvisionRes"
-        403:
+        '403':
           description: Unauthorized.
-        500:
+        '500':
           description: Unexpected server-side error ocurred.
 
 components:

readers/openapi.yml

@@ -21,13 +21,13 @@ paths:
         - $ref: "#/components/parameters/Offset"
         - $ref: "#/components/parameters/ChanId"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/MessagesPageRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
 
 components:

things/openapi.yml

@@ -18,22 +18,22 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ThingCreateReq"
       responses:
-        201:
+        '201':
           $ref: "#/components/responses/CreateThingRes"
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        409:
+        '409':
           description: Entity already exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        422:
+        '422':
           description: Database can't process request.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     get:
-      summary: Retrieves managed things
+      summary: Retrieves things
       description: |
         Retrieves a list of managed things. Due to performance concerns, data
         is retrieved in subsets. The API things must ensure that the entire
@@ -50,17 +50,17 @@ paths:
         - $ref: "#/components/parameters/Direction"
         - $ref: "#/components/parameters/Metadata"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ThingsPageRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: A non-existent entity request.
-        422:
+        '422':
           description: Database can't process request.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/bulk:
     post:
@@ -75,15 +75,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ThingsCreateReq"
       responses:
-        201:
+        '201':
           description: Things registered.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/{thingId}:
     get:
@@ -94,15 +94,15 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ThingId"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ThingRes"
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Thing does not exist.
-        422:
+        '422':
           description: Database can't process request.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     put:
       summary: Updates thing info
@@ -118,17 +118,17 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ThingUpdateReq"
       responses:
-        200:
+        '200':
           description: Thing updated.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Thing does not exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     delete:
       summary: Removes a thing
@@ -141,13 +141,13 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ThingId"
       responses:
-        204:
+        '204':
           description: Thing removed.
-        400:
+        '400':
           description: Failed due to malformed thing's ID.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/{thingId}/key:
     patch:
@@ -162,19 +162,19 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/KeyUpdateReq"
       responses:
-        200:
+        '200':
           description: Thing key updated.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Thing does not exist.
-        409:
+        '409':
           description: Specified key already exists.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /channels:
     post:
@@ -189,17 +189,17 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ChannelCreateReq"
       responses:
-        201:
+        '201':
           $ref: "#/components/responses/ChannelCreateRes"
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        409:
+        '409':
           description: Entity already exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     get:
       summary: Retrieves managed channels
@@ -219,15 +219,15 @@ paths:
         - $ref: "#/components/parameters/Direction"
         - $ref: "#/components/parameters/Metadata"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ChannelsPageRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        422:
+        '422':
           description: Database can't process request.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /channels/bulk:
     post:
@@ -242,17 +242,17 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ChannelsCreateReq"
       responses:
-        201:
+        '201':
           description: Channels registered.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        409:
+        '409':
           description: Entity already exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /channels/{chanId}:
     get:
@@ -263,17 +263,17 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ChanId"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ChannelRes"
-        400:
+        '400':
           description: Failed due to malformed channel's ID.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Channel does not exist.
-        422:
+        '422':
           description: Database can't process request.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     put:
       summary: Updates channel info
@@ -289,17 +289,17 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ChannelCreateReq"
       responses:
-        200:
+        '200':
           description: Channel updated.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Channel does not exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     delete:
       summary: Removes a channel
@@ -312,13 +312,13 @@ paths:
         - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ChanId"
       responses:
-        204:
+        '204':
           description: Channel removed.
-        400:
+        '400':
           description: Failed due to malformed channel's ID.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /connect:
     post:
@@ -333,71 +333,73 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/ConnCreateReq"
       responses:
-        201:
+        '201':
           $ref: "#/components/responses/ConnCreateRes"
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: A non-existent entity request.
-        409:
+        '409':
           description: Entity already exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /things/{thingId}/channels:
     get:
-      summary: Retrieves list of channels connected or not connected to specified thing
+      summary: List of channels connected to specified thing
       description: |
         Retrieves list of channels connected to specified thing with pagination
         metadata.
       tags:
         - channels
       parameters:
+        - $ref: "#/components/parameters/Authorization"
         - $ref: "#/components/parameters/ThingId"
         - $ref: "#/components/parameters/Offset"
         - $ref: "#/components/parameters/Limit"
         - $ref: "#/components/parameters/Connected"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ChannelsPageRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Thing does not exist.
-        422:
+        '422':
           description: Database can't process request.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /channels/{chanId}/things:
     get:
-      summary: Retrieves list of things connected or not connected to specified channel
+      summary: List of things connected to specified channel
       description: |
         Retrieves list of things connected to specified channel with pagination
         metadata.
       tags:
         - things
       parameters:
+        - $ref: "#/components/parameters/Authorization"        
         - $ref: "#/components/parameters/ChanId"
         - $ref: "#/components/parameters/Offset"
         - $ref: "#/components/parameters/Limit"
         - $ref: "#/components/parameters/Connected"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/ThingsPageRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: A non-existent entity request.
-        422:
+        '422':
           description: Database can't process request.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /channels/{chanId}/things/{thingId}:
     put:
@@ -412,15 +414,15 @@ paths:
         - $ref: "#/components/parameters/ChanId"
         - $ref: "#/components/parameters/ThingId"
       responses:
-        200:
+        '200':
           description: Thing connected.
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Channel or thing does not exist.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     delete:
       summary: Disconnects the thing from the channel
@@ -434,15 +436,15 @@ paths:
         - $ref: "#/components/parameters/ChanId"
         - $ref: "#/components/parameters/ThingId"
       responses:
-        204:
+        '204':
           description: Thing disconnected.
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        401:
+        '401':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Channel or thing does not exist.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /channels/{chanId}/access:
     post:
@@ -457,15 +459,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/IdentityReq"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/AccessGrantedRes"
-        401:
+        '401':
           description: |
             Thing and channel are not connected, or thing with specified key doesn't
             exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /channels/{chanId}/access-by-id:
     post:
@@ -480,15 +482,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/AccessByIDReq"
       responses:
-        200:
+        '200':
           description: Thing has access to the specified channel.
-        401:
+        '401':
           description: |
             Thing and channel are not connected, or thing with specified ID doesn't
             exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
   /identify:
     post:
@@ -501,13 +503,13 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/IdentityReq"
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/IdentityRes"
-        401:
+        '401':
           description: Thing with specified key doesn't exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
 
 
@@ -621,8 +623,6 @@ components:
     ConnectionReqSchema:
       type: object
       properties:
-        key:
-          $ref: "#/components/schemas/Key"
         channel_ids:
           type: array
           description: Channel IDs.
@@ -641,6 +641,7 @@ components:
       in: header
       schema:
         type: string
+        format: uuid
       required: true
     ChanId:
       name: chanId

twins/openapi.yml

@@ -18,15 +18,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/TwinReq"
       responses:
-        201:
+        '201':
           $ref: "#/components/responses/TwinCreateRes"
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
 
     get:
@@ -43,13 +43,13 @@ paths:
         - $ref: '#/components/parameters/Name'
         - $ref: '#/components/parameters/Metadata'
       responses:
-        200:
+        '200':
           $ref: '#/components/responses/TwinsPageRes'
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
 
   /twins/{twinID}:
@@ -61,15 +61,15 @@ paths:
         - $ref: '#/components/parameters/Authorization'
         - $ref: '#/components/parameters/TwinID'
       responses:
-        200:
+        '200':
           $ref: '#/components/responses/TwinRes'
-        400:
+        '400':
           description: Failed due to malformed twin's ID.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Twin does not exist.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
     put:
       summary: Updates twin info
@@ -84,17 +84,17 @@ paths:
       requestBody:
         $ref: '#/components/requestBodies/TwinReq'
       responses:
-        200:
+        '200':
           description: Twin updated.
-        400:
+        '400':
           description: Failed due to malformed twin's ID or malformed JSON.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Twin does not exist.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
     delete:
       summary: Removes a twin
@@ -105,15 +105,15 @@ paths:
         - $ref: '#/components/parameters/Authorization'
         - $ref: '#/components/parameters/TwinID'
       responses:
-        204:
+        '204':
           description: Twin removed.
-        400:
+        '400':
           description: Failed due to malformed twin's ID.
-        403:
+        '403':
           description: Missing or invalid access token provided
-        404:
+        '404':
           description: Twin does not exist.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
 
   /states/{twinID}:
@@ -131,15 +131,15 @@ paths:
         - $ref: '#/components/parameters/Offset'
         - $ref: '#/components/parameters/Metadata'
       responses:
-        200:
+        '200':
           $ref: '#/components/responses/StatesPageRes'
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        404:
+        '404':
           description: Twin does not exist.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
 
 components:

users/openapi.yml

@@ -16,15 +16,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/UserCreateReq"
       responses:
-        201:
+        '201':
           $ref: "#/components/responses/UserCreateRes"
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        409:
+        '409':
           description: Failed due to using an existing email address.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     get:
       summary: Gets info on currently logged in user.
@@ -36,13 +36,13 @@ paths:
       security:
         - Authorization: []
       responses:
-        200:
+        '200':
           $ref: "#/components/responses/UserRes"
-        400:
+        '400':
           description: Failed due to malformed query parameters.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
     put:
       summary: Updates info on currently logged in user.
@@ -56,15 +56,15 @@ paths:
       requestBody:
         $ref: "#/components/requestBodies/UserUpdateReq"
       responses:
-        200:
+        '200':
           description: User updated.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        404:
+        '404':
           description: Failed due to non existing user.
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
          $ref: "#/components/responses/ServiceError"
   /users/{userId}/groups:
     get:
@@ -79,11 +79,11 @@ paths:
         - $ref: "#/components/parameters/Offset"
         - $ref: "#/components/parameters/Limit"
       responses:
-        200:
+        '200':
           $ref: '#/components/responses/GroupsRes'
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
   /groups:
     post:
@@ -97,15 +97,15 @@ paths:
       requestBody:
         $ref: '#/components/requestBodies/CreateGroupReq'
       responses:
-        200:
+        '200':
           description: Group created.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Group'
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
     get:
       summary: Get users groups
@@ -116,15 +116,15 @@ paths:
       security:
         - Authorization: []
       responses:
-        200:
+        '200':
           description: Groups retrieved.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/GroupsPage'
-        403:
+        '403':
           description: Missing or invalid access token provided.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
   /tokens:
     post:
@@ -132,34 +132,34 @@ paths:
       description: Generates an access token when provided with proper credentials.
       tags:
         - users
-      security:
-        - Authorization: []
+      requestBody:
+        $ref: "#/components/requestBodies/UserCreateReq"
       responses:
-        201:
+        '201':
           description: User authenticated.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Token'
-        400:
+        '400':
           description: Failed due to malformed JSON.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
-        403:
+        '403':
           description: Failed due to using invalid credentials.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
-        415:
+        '415':
           description: Missing or invalid content type.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
   /password/reset-request:
     post:
@@ -174,13 +174,13 @@ paths:
       requestBody:
         $ref: '#/components/requestBodies/RequestPasswordReset'
       responses:
-        201:
+        '201':
           description: Users link for reseting password.
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
   /password/reset:
     put:
@@ -194,13 +194,13 @@ paths:
       requestBody:
         $ref: '#/components/requestBodies/PasswordReset'
       responses:
-        201:
+        '201':
           description: User link .
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: '#/components/responses/ServiceError'
   /password:
     patch:
@@ -214,13 +214,13 @@ paths:
       requestBody:
         $ref: '#/components/requestBodies/PasswordChange'
       responses:
-        201:
+        '201':
           description: User link .
-        400:
+        '400':
           description: Failed due to malformed JSON.
-        415:
+        '415':
           description: Missing or invalid content type.
-        500:
+        '500':
           $ref: "#/components/responses/ServiceError"
 
 components: