adds device token endpoint

This endpoint is for pushing a device token that can be used later to send
push notifications to the device.

BACK-2506

reference/auth.v1.yaml

@@ -722,6 +722,27 @@ paths:
       security:
         - serverToken: []
 
+  '/auth/v1/users/{userId}/device_tokens':
+    parameters:
+      - $ref: './common/parameters/tidepooluserid.yaml'
+    post:
+      operationId: PostDeviceToken
+      summary: Post Device Token
+      description: >-
+        Stores a token used to send notifications to a device such as a mobile phone.
+      responses:
+        '200':
+          description: 200 OK
+        '400':
+          $ref: './common/responses/badrequest.v1.yaml'
+        '403':
+          $ref: './common/responses/forbidden.v1.yaml'
+      tags:
+        - Authentication
+        - Internal
+      security:
+        - sessionToken: []
+
 components:
   securitySchemes:
     basicAuth: