Merge branch 'main' into corrections

src/models/AuthPinContainer.yaml

@@ -69,7 +69,7 @@ properties:
     example: 7RQZ
   product:
     type: string
-    example: "0"
+    example: "Tautulli"
   trusted:
     type: boolean
     default: false
@@ -79,6 +79,7 @@ properties:
   clientIdentifier:
     type: string
     description: The X-Client-Identifier used in the request
+    example: "Tautulli"
   location:
     $ref: ./GeoData.yaml
   expiresIn:
@@ -95,6 +96,7 @@ properties:
     format: date-time
     example: "2024-07-16T17:18:05Z"
   authToken:
-    type: "null"
+    type: [string, "null"]
+    example: "gcgzw5rz2xovp84b4vha3a40"
   newRegistration:
     type: "null"

src/models/GeoData.yaml

@@ -52,9 +52,9 @@ properties:
     description: The time zone of the country.
     example: America/St_Thomas
   postal_code:
-    type: integer
+    type: string
     description: The postal code of the location.
-    example: 802
+    example: "802"
   in_privacy_restricted_country:
     type: boolean
     description: Indicates if the country has privacy restrictions.

src/parameters/plex/x-plex-device.yaml

@@ -1,4 +1,5 @@
 name: X-Plex-Device
+x-speakeasy-name-override: DeviceName
 in: query
 required: false
 schema:

src/parameters/plex/x-plex-identifier.yaml

@@ -1,4 +1,5 @@
 name: X-Plex-Client-Identifier
+x-speakeasy-name-override: ClientID
 description: |
   The unique identifier for the client application
   This is used to track the client application and its usage

src/parameters/plex/x-plex-platform.yaml

@@ -1,4 +1,5 @@
 name: X-Plex-Platform
+x-speakeasy-name-override: ClientPlatform
 in: query
 required: false
 schema:

src/parameters/plex/x-plex-product.yaml

@@ -1,4 +1,5 @@
 name: X-Plex-Product
+x-speakeasy-name-override: ClientName
 in: query
 required: false
 schema:

src/parameters/plex/x-plex-version.yaml

@@ -1,4 +1,5 @@
 name: X-Plex-Version
+x-speakeasy-name-override: ClientVersion
 in: query
 required: false
 schema:

src/paths/pins/pins.yaml

@@ -5,7 +5,7 @@ post:
     - Plex
   summary: Get a Pin
   operationId: getPin
-  description: Retrieve a Pin from Plex.tv for authentication flows
+  description: Retrieve a Pin ID from Plex.tv to use for authentication flows
   security: [] # No security required
   parameters:
     - name: strong
@@ -19,8 +19,11 @@ post:
         default: false
       required: false
     - $ref: ../../parameters/plex/x-plex-product.yaml
+    - $ref: ../../parameters/plex/x-plex-device.yaml
+    - $ref: ../../parameters/plex/x-plex-version.yaml
+    - $ref: ../../parameters/plex/x-plex-platform.yaml
   responses:
-    "200":
+    "201":
       description: Requests a new pin id used in the authentication flow
       content:
         application/json:

src/paths/playlists/upload.yaml

@@ -32,6 +32,14 @@ post:
           - 0
           - 1
       required: true
+    - name: sectionID
+      description: Possibly the section ID to upload the playlist to, we are not certain.
+      in: query
+      schema:
+        type: integer
+        example: 1
+        default: 1
+      required: true
   responses:
     "200":
       description: The playlist is uploaded

src/pms-spec.yaml

@@ -31,6 +31,10 @@ servers:
 x-speakeasy-globals:
   parameters:
     - $ref: "./parameters/plex/x-plex-identifier.yaml"
+    - $ref: "./parameters/plex/x-plex-product.yaml"
+    - $ref: "./parameters/plex/x-plex-version.yaml"
+    - $ref: "./parameters/plex/x-plex-platform.yaml"
+    - $ref: "./parameters/plex/x-plex-device.yaml"
 
 security:
   - accessToken: []