From 0d8f198f1f56ce034dd6c49d9a09b51e309b929c Mon Sep 17 00:00:00 2001
From: Jason <jnorris441@gmail.com>
Date: Fri, 15 Mar 2024 23:45:59 -0700
Subject: [PATCH] Update pins-id.yaml 200 response

I believe this is the correct response...it returns the full pin with authToken=null until after it's verified
---
 plextv/paths/pins-id.yaml | 77 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 76 insertions(+), 1 deletion(-)

diff --git a/plextv/paths/pins-id.yaml b/plextv/paths/pins-id.yaml
index f1b45977..3e0300a5 100644
--- a/plextv/paths/pins-id.yaml
+++ b/plextv/paths/pins-id.yaml
@@ -16,7 +16,82 @@ get:
 
   responses:
     "200":
-      description: Access Token
+      description: The pin with a non-null authToken after verification
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              id:
+                description: PinID for use with authentication
+                type: number
+                example: 1272322473
+              code:
+                type: string
+                example: 3patfx1a78ukcbr7x0n9bl26t
+              product:
+                type: string
+                example: Plex Web
+              trusted:
+                type: boolean
+              qr:
+                description: |
+                  a link to a QR code hosted on plex.tv 
+                  The QR code redirects to the relevant `plex.tv/link` authentication page
+                  Which then prompts the user for the 4 Digit Link Pin
+                type: string
+                example: https://plex.tv/api/v2/pins/qr/3patfx1a78ukcbr7x0n9bl26t
+              clientIdentifier:
+                type: string
+                example: Postman
+              location:
+                type: object
+                properties:
+                  code:
+                    type: string
+                    example: US
+                  european_union_member:
+                    type: boolean
+                  continent_code:
+                    type: string
+                    example: NA
+                  country:
+                    type: string
+                    example: United States
+                  city:
+                    type: string
+                    example: Austin
+                  time_zone:
+                    type: string
+                    example: America/Chicago
+                  postal_code:
+                    type: number
+                    example: 78732
+                  in_privacy_restricted_country:
+                    type: boolean
+                  subdivisions:
+                    type: string
+                    example: Texas
+                  coordinates:
+                    type: string
+                    example: 30.3768 -97.8935
+              expiresIn:
+                type: number
+                example: 1800
+              createdAt:
+                type: string
+                format: date-time
+                example: 2023-04-12T17:00:03Z
+              expiresAt:
+                type: string
+                format: date-time
+                example: 2023-04-12T17:30:03Z
+              authToken:
+                type: string
+                format: nullable
+              newRegistration:
+                type: string
+                format: nullable
     "400":
       description: X-Plex-Client-Identifier is missing
       content: