Updated pins endpoint

paths/pins/pins-id.yaml

@@ -1,23 +1,23 @@
 get:
   servers:
     - url: https://plex.tv/api/v2
+  security: [] # No security required
   tags:
     - Plex
-  summary: Get Access Token
-  operationId: getToken
-  description: Retrieve an Access Token from Plex.tv after the Pin has already been authenticated
-  security: [] # No security required
+  summary: Get Access Token by PinId
+  description: Retrieve an Access Token from Plex.tv after the Pin has been authenticated
+  operationId: getTokenByPinId
   parameters:
     - name: pinID
       description: The PinID to retrieve an access token for
       in: path
-      schema:
-        type: string
       required: true
+      schema:
+        type: integer
     - $ref: "../../parameters/ClientIdentifier.yaml"
   responses:
     '200':
-      description: The Pin
+      description: The Pin with a non-null authToken when it has been verified by the user
       content:
         application/json:
           schema:
@@ -27,3 +27,25 @@ get:
         application/json:
           schema:
              $ref: ../../responses/400-MissingIdentifier.yaml
+    '404':
+      description: Not Found or Expired
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              errors:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    code:
+                      type: integer
+                      example: 1020
+                    message:
+                      type: string
+                      example: Code not found or expired
+          example:
+            errors:
+              - code: 1020
+                message: Code not found or expired

paths/pins/pins.yaml

@@ -22,7 +22,7 @@ post:
     - $ref: ../../parameters/ClientProduct.yaml
   responses:
     '200':
-      description: The Pin
+      description: Requests a new pin id used in the authentication flow
       content:
         application/json:
           schema: