diff --git a/static/plex-api-spec-dereferenced.yaml b/static/plex-api-spec-dereferenced.yaml index 8ca0999..1c6de36 100644 --- a/static/plex-api-spec-dereferenced.yaml +++ b/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