Updating OpenAPI Spec

static/plex-api-spec-dereferenced.yaml

@@ -1,8 +1,9 @@
-openapi: 3.0.1
+openapi: 3.1.1
 info:
   title: Plex-API
+  summary: A Plex Media Server API Map
   description: An Open API Spec for interacting with Plex.tv and Plex Servers
-  version: 0.0.1
+  version: 0.0.2
   contact:
     name: Luke Hagar
     email: Lukeslakemail@gmail.com
@@ -22,7 +23,6 @@ servers:
       Port:
         default: '32400'
         description: The port to access your plex server
-  - url: https://plex.tv/api/v2
 security:
   - PlexToken: []
 components:
@@ -418,6 +418,60 @@ paths:
           description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
         '404':
           description: The task was not running
+  /log:
+    get:
+      tags:
+        - Log
+      summary: Logging a single-line message to the Plex Media Server log.
+      description: |
+        This endpoint will write a single-line log message, including a level and source to the main Plex Media Server log.
+      operationId: logaLine
+      parameters:
+        - name: level
+          description: |
+            An integer log level to write to the PMS log with.  
+            (0: Error, 1: Warning, 2: Info, 3: Debug, 4: Verbose)
+          in: query
+          schema:
+            type: number
+            enum:
+              - 0
+              - 1
+              - 2
+              - 3
+              - 4
+          required: true
+        - name: message
+          description: The text of the message to write to the log.
+          in: query
+          schema:
+            type: string
+            example: ''
+          required: true
+        - name: source
+          description: a string indicating the source of the message.
+          in: query
+          schema:
+            type: string
+            example: ''
+          required: true
+      responses:
+        '200':
+          description: Log Line submitted successfully
+        '401':
+          description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
+    post:
+      tags:
+        - Log
+      summary: Logging a multi-line message to the Plex Media Server log
+      description: |
+        This endpoint will write multiple lines to the main Plex Media Server log in a single request. It takes a set of query strings as would normally sent to the above GET endpoint as a linefeed-separated block of POST data. The parameters for each query string match as above.
+      operationId: logMultipleLines
+      responses:
+        '200':
+          description: Multi-Line Log Message Posted successfully
+        '401':
+          description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
 tags:
   - name: Activities
     description: |
@@ -430,7 +484,7 @@ tags:
       - The may contain a `Response` object which attributes which represent the result of the asynchronous operation.
   - name: Butler
     description: |
-      Butler is the task manager of the plex ecosystem.
+      Butler is the task manager of the Plex Media Server Ecosystem.
   - name: Server
     description: |
       Operations against the Plex Media Server System.
@@ -438,3 +492,6 @@ tags:
     description: |
       This describes the API for searching and applying updates to the Plex Media Server.
       Updates to the status can be observed via the Event API.
+  - name: Log
+    description: |
+      Submit logs to the Log Handler for Plex Media Server