Fixed some minor bugs and added to root

docs/controllers/LibraryItemController.yaml

@@ -40,7 +40,7 @@ paths:
                       description: TODO
                       oneOf:
                         - $ref: '../objects/LibraryItem.yaml#/components/schemas/libraryItem'
-  /api/items/{id}/play:
+  /api/items/{id}/play/{episodeId}:
     parameters:
       - name: id
         in: path
@@ -48,6 +48,12 @@ paths:
         required: true
         schema:
           $ref: '../objects/LibraryItem.yaml#/components/schemas/libraryItemId'
+      - name: episodeId
+        in: path
+        description: The ID of the episode to play.
+        required: false
+        schema:
+          $ref: '../objects/mediaTypes/Podcast.yaml#/components/schemas/podcastId'
     post:
       operationId: playLibraryItem
       summary: Play a library item.

docs/controllers/MeController.yaml

@@ -0,0 +1,2 @@
+paths:
+

docs/objects/entities/PlaybackSession.yaml

@@ -5,6 +5,9 @@ components:
       type: string
       format: uuid
     playbackSession:
+      type: object
+      description: A playback session object.
+      properties:
         id:
           $ref: '#/components/schemas/playbackSessionId'
         userId:
@@ -14,15 +17,14 @@ components:
         libraryItemId:
           $ref: '../LibraryItem.yaml#/components/schemas/libraryItemId'
         episodeId:
-        $ref: '../mediaTypes/Podcast.yaml#/components/schemas/episodeId'
+          $ref: '../mediaTypes/Podcast.yaml#/components/schemas/podcastId'
-        nullable: true
         mediaType:
-        $ref: '../../controllers/LibraryItemController.yaml#/components/schemas/libraryMediaType'
+          $ref: '../mediaTypes/media.yaml#/components/schemas/mediaType'
         mediaMetadata:
           description: The metadata of the media.
           oneOf:
             - $ref: '../mediaTypes/Book.yaml#/components/schemas/bookMinified'
-          - $ref: '../mediaTypes/Podcast.yaml#/components/schemas/podcastMinified'
+            - $ref: '../mediaTypes/Podcast.yaml#/components/schemas/Podcast'
         chapters:
           description: The chapters of the media.
           type: array
@@ -35,9 +37,9 @@ components:
           description: The display author of the media.
           type: string
         coverPath:
-        $ref: '../Book.yaml#/components/schemas/bookCoverPath'
+          $ref: '../mediaTypes/Book.yaml#/components/schemas/bookCoverPath'
         duration:
-        $ref: '../schemas.yaml#/components/schemas/durationSec'
+          $ref: '../../schemas.yaml#/components/schemas/durationSec'
         playMethod:
           type: integer
           description: The method used to play the media. 0 = Direct play, 1 = Direct Stream, 2 = Transcode, 3 = Local
@@ -47,23 +49,23 @@ components:
         deviceInfo:
           $ref: './Device.yaml#/components/schemas/deviceInfo'
         serverVersion:
-        $ref: '../schemas.yaml#/components/schemas/serverVersion'
+          $ref: '../../schemas.yaml#/components/schemas/serverVersion'
         date:
           description: TODO
-        type: String
+          type: string
         dayOfWeek:
           description: TODO
-        type: String
+          type: string
         timeListening:
-        $ref: '../schemas.yaml#/components/schemas/durationSec'
+          $ref: '../../schemas.yaml#/components/schemas/durationSec'
         startTime:
-        $ref: '../schemas.yaml#/components/schemas/durationSec'
+          $ref: '../../schemas.yaml#/components/schemas/durationSec'
         currentTime:
-        $ref: '../schemas.yaml#/components/schemas/durationSec'
+          $ref: '../../schemas.yaml#/components/schemas/durationSec'
         createdAt:
-        $ref: '../schemas.yaml#/components/schemas/createdAt'
+          $ref: '../../schemas.yaml#/components/schemas/createdAt'
         updatedAt:
-        $ref: '../schemas.yaml#/components/schemas/updatedAt'
+          $ref: '../../schemas.yaml#/components/schemas/updatedAt'
     playbackSessionExpanded:
       description: Expanded playback session schema.
       allOf:

docs/root.yaml

@@ -83,6 +83,8 @@ paths:
     $ref: './controllers/AuthController.yaml#/paths/~1logout'
   /api/items/{id}:
     $ref: './controllers/LibraryItemController.yaml#/paths/~1api~1items~1{id}'
+  /api/items/{id}/play/{episodeId}:
+    $ref: './controllers/LibraryItemController.yaml#/paths/~1api~1items~1{id}~1play~1{episodeId}'
 tags:
   - name: Authors
     description: Author endpoints