From aa4ef4068ef4dd49a849c0f69a7a63f3c9f73649 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Franti=C5=A1ek=20Augusztin?= <faugusztin@goldmann.sk>
Date: Thu, 13 Jun 2024 20:16:57 +0200
Subject: [PATCH] Add response to pins call to be able to get authToken

The response of getToken is identical to the pins call with 200 HTTP code.
---
 paths/pins/pins-id.yaml | 74 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/paths/pins/pins-id.yaml b/paths/pins/pins-id.yaml
index 0719a7c9..05fa7b2f 100644
--- a/paths/pins/pins-id.yaml
+++ b/paths/pins/pins-id.yaml
@@ -18,6 +18,80 @@ get:
   responses:
     "200":
       description: Access Token
+      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: string
+                    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: