cleanup

src/models/common/PlexMediaType.yaml

@@ -1,19 +1,23 @@
 type: integer
 x-speakeasy-unknown-values: allow
 enum:
-  - 1
+  - 1 # MOVIE
-  - 2
+  - 2 # TV_SHOW
-  - 3
+  - 3 # SEASON
-  - 4
+  - 4 # EPISODE
-  - 8
+  - 5 # ARTIST
-  - 9
+  - 6 # ALBUM
-  - 10
+  - 7 # TRACK
+  - 8 # PHOTO_ALBUM
+  - 9 # PHOTO
 example: 2
 x-speakeasy-enums:
   - MOVIE
   - TV_SHOW
   - SEASON
   - EPISODE
-  - AUDIO
+  - ARTIST
   - ALBUM
   - TRACK
+  - PHOTO_ALBUM
+  - PHOTO

src/models/common/PlexMediaTypeString.yaml

@@ -7,9 +7,13 @@ enum:
   - episode
   - artist
   - album
+  - track
+  - photoalbum
+  - photo
+  - collection
 example: "movie"
 description: |
-  The type of media content
+  The type of media content in the Plex library. This can represent videos, music, or photos.
 x-speakeasy-enums:
   - MOVIE
   - TV_SHOW
@@ -17,3 +21,7 @@ x-speakeasy-enums:
   - EPISODE
   - ARTIST
   - ALBUM
+  - TRACK
+  - PHOTO_ALBUM
+  - PHOTO
+  - COLLECTION

src/models/country/filter.yaml

@@ -1,4 +1,6 @@
 type: object
+required:
+  - filter
 description: "The filter query string for country media items."
 properties:
   filter:

src/models/country/id.yaml

@@ -6,4 +6,5 @@ properties:
   id:
     type: integer
     format: int32
+    minimum: 1
     example: 259

src/models/director/id.yaml

@@ -6,4 +6,5 @@ properties:
     description: "Unique identifier for the director."
     type: integer
     format: int32
+    minimum: 1
     example: 126522

src/models/director/tag-key.yaml

@@ -1,7 +1,9 @@
 type: object
+required:
+  - tagKey
 properties:
   tagKey:
-    description: "A unique key associated with the director's tag, used for internal identification."
+    description: "A unique 24-character hexadecimal key associated with the director's tag, used for internal identification."
     type: string
     pattern: "^[a-fA-F0-9]{24}$"
     example: "5d776831151a60001f24d031"

src/models/director/thumb.yaml

@@ -1,6 +1,6 @@
 type: object
 properties:
   thumb:
-    description: "The URL of the thumbnail image for the director."
+    description: "The absolute URL of the thumbnail image for the director."
     type: string
     example: "https://metadata-static.plex.tv/8/people/8d65fa96804802e08f2de09fe014408e.jpg"

src/models/genre/id.yaml

@@ -5,4 +5,6 @@ description: "The identifier for the genre"
 properties:
   id:
     type: integer
+    format: int32
+    minimum: 1
     example: 259

src/models/producer/id.yaml

@@ -6,4 +6,5 @@ properties:
     description: "Unique identifier for the producer."
     type: integer
     format: int32
+    minimum: 1
     example: 126522

src/models/producer/tag-key.yaml

@@ -1,7 +1,9 @@
 type: object
+required:
+  - tagKey
 properties:
   tagKey:
-    description: "A unique key associated with the producer's tag, used for internal identification."
+    description: "A 24-character hexadecimal unique key associated with the producer's tag, used for internal identification."
     type: string
     pattern: "^[a-fA-F0-9]{24}$"
     example: "5d77683d85719b001f3a535e"

src/models/producer/thumb.yaml

@@ -1,6 +1,6 @@
 type: object
 properties:
   thumb:
-    description: "The URL of the thumbnail image for the actor."
+    description: "The absolute URL of the thumbnail image for the actor."
     type: string
     example: "https://metadata-static.plex.tv/7/people/708568fd018d7aa8b1032dcf867747e8.jpg"

src/models/rating/value.yaml

@@ -1,4 +1,3 @@
-
 type: object
 required:
   - value
@@ -6,5 +5,5 @@ description: "The numerical rating value."
 properties:
   value:
     type: number
+    format: float
     example: 5.1
-

src/models/role/id.yaml

@@ -5,4 +5,6 @@ properties:
   id:
     description: "Unique identifier for the actor or role."
     type: integer
+    format: int32
+    minimum: 1
     example: 126522

src/models/role/tag-key.yaml

@@ -1,6 +1,9 @@
 type: object
+required:
+  - tagKey
 properties:
   tagKey:
-    description: "A unique key associated with the actor's tag, used for internal identification."
+    description: "A 24-character hexadecimal unique key associated with the actor's tag, used for internal identification."
     type: string
+    pattern: "^[a-fA-F0-9]{24}$"
     example: "5d77683d85719b001f3a535e"

src/models/role/thumb.yaml

@@ -1,6 +1,6 @@
 type: object
 properties:
   thumb:
-    description: "The URL of the thumbnail image for the actor."
+    description: "The absolute URL of the thumbnail image for the actor."
     type: string
     example: "https://metadata-static.plex.tv/7/people/708568fd018d7aa8b1032dcf867747e8.jpg"

src/models/similar/filter.yaml

@@ -1,4 +1,3 @@
-
 type: object
 required:
   - filter
@@ -7,4 +6,3 @@ properties:
   filter:
     type: string
     example: "similar=259"
-

src/models/similar/id.yaml

@@ -1,4 +1,3 @@
-
 type: object
 required:
   - id
@@ -6,5 +5,6 @@ description: "The identifier for the similar media item."
 properties:
   id:
     type: integer
+    format: int32
+    minimum: 1
     example: 259
-

src/models/similar/tag.yaml

@@ -1,4 +1,3 @@
-
 type: object
 required:
   - tag
@@ -7,4 +6,3 @@ properties:
   tag:
     type: string
     example: "Criss Angel Mindfreak"
-

src/models/writer/id.yaml

@@ -6,4 +6,5 @@ properties:
     description: "Unique identifier for the writer."
     type: integer
     format: int32
+    minimum: 1
     example: 126522

src/models/writer/tag-key.yaml

@@ -1,7 +1,9 @@
 type: object
+required:
+  - tagKey
 properties:
   tagKey:
-    description: "A unique key associated with the writers tag, used for internal identification."
+    description: "A 24-character hexadecimal unique key associated with the writers tag, used for internal identification."
     type: string
     pattern: "^[a-fA-F0-9]{24}$"
     example: "5d77683d85719b001f3a535e"

src/models/writer/thumb.yaml

@@ -1,6 +1,6 @@
 type: object
 properties:
   thumb:
-    description: "The URL of the thumbnail image for the writer."
+    description: "The absolute URL of the thumbnail image for the writer."
     type: string
     example: "https://metadata-static.plex.tv/8/people/8d65fa96804802e08f2de09fe014408e.jpg"