LukeParke/plex-docs
1
0
Fork 0
mirror of https://github.com/LukeHagar/plex-docs.git synced 2025-12-06 04:20:40 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
c32a5e6c95af2092899573f7dde737407d62b534
plex-docs/static/plex-api-spec-dereferenced.yaml
lukehagar c32a5e6c95 Updating OpenAPI Spec
2023-04-14 01:36:57 +00:00

5286 lines
171 KiB
YAML
Raw Blame History

openapi: 3.1.0
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.3
contact:
name: Luke Hagar
url: 'https://www.LukeHagar.com'
email: Lukeslakemail@gmail.com
license:
name: MIT
identifier: MIT
url: 'https://opensource.org/licenses/MIT'
servers:
- url: '{Protocol}://{Local IP}:{Port}'
variables:
Protocol:
enum:
- http
- https
default: http
description: The protocol to use with your plex server
Local IP:
default: 10.10.10.47
description: The Local IP Address of your plex server
Port:
default: '32400'
description: The port to access your plex server
security:
- PlexToken: []
PlexClientIdentifier: []
components:
securitySchemes:
PlexToken:
type: apiKey
in: header
name: X-Plex-Token
PlexClientIdentifier:
type: apiKey
in: header
name: X-Plex-Client-Identifier
paths:
/:
get:
tags:
- Server
summary: Server Capabilities
description: Server Capabilities
operationId: getServerCapabilities
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The Server Capabilities
content:
application/json:
schema:
type: object
properties:
MediaContainer:
type: object
properties:
size:
type: number
allowCameraUpload:
type: boolean
allowChannelAccess:
type: boolean
allowMediaDeletion:
type: boolean
allowSharing:
type: boolean
allowSync:
type: boolean
allowTuners:
type: boolean
backgroundProcessing:
type: boolean
certificate:
type: boolean
companionProxy:
type: boolean
countryCode:
type: string
diagnostics:
type: string
eventStream:
type: boolean
friendlyName:
type: string
hubSearch:
type: boolean
itemClusters:
type: boolean
livetv:
type: number
machineIdentifier:
type: string
mediaProviders:
type: boolean
multiuser:
type: boolean
musicAnalysis:
type: number
myPlex:
type: boolean
myPlexMappingState:
type: string
myPlexSigninState:
type: string
myPlexSubscription:
type: boolean
myPlexUsername:
type: string
offlineTranscode:
type: number
ownerFeatures:
type: string
photoAutoTag:
type: boolean
platform:
type: string
platformVersion:
type: string
pluginHost:
type: boolean
pushNotifications:
type: boolean
readOnlyLibraries:
type: boolean
streamingBrainABRVersion:
type: number
streamingBrainVersion:
type: number
sync:
type: boolean
transcoderActiveVideoSessions:
type: number
transcoderAudio:
type: boolean
transcoderLyrics:
type: boolean
transcoderPhoto:
type: boolean
transcoderSubtitles:
type: boolean
transcoderVideo:
type: boolean
transcoderVideoBitrates:
type: string
transcoderVideoQualities:
type: string
transcoderVideoResolutions:
type: string
updatedAt:
type: number
updater:
type: boolean
version:
type: string
voiceSearch:
type: boolean
Directory:
type: array
items:
type: object
properties:
count:
type: number
key:
type: string
title:
type: string
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/clients:
get:
tags:
- Devices
summary: Get Available Clients
description: Get Available Clients
operationId: getAvailableClients
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Available Clients
content:
application/json:
schema:
type: array
items:
type: object
properties:
MediaContainer:
type: object
properties:
size:
type: number
example: 1
Server:
type: array
items:
type: object
properties:
name:
type: string
example: iPad
host:
type: string
example: 10.10.10.102
address:
type: string
example: 10.10.10.102
port:
type: number
example: 32500
machineIdentifier:
type: string
example: A2E901F8-E016-43A7-ADFB-EF8CA8A4AC05
version:
type: string
example: 8.17
protocol:
type: string
example: plex
product:
type: string
example: Plex for iOS
deviceClass:
type: string
example: tablet
protocolVersion:
type: string
example: 2
protocolCapabilities:
type: string
example: 'playback,playqueues,timeline,provider-playback'
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/activities:
get:
tags:
- Activities
summary: Get Server Activities
description: Get Server Activities
operationId: getServerActivities
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The Server Activities
content:
application/json:
schema:
type: object
properties:
MediaContainer:
type: object
properties:
size:
type: number
Activity:
type: array
items:
type: object
properties:
uuid:
type: string
type:
type: string
cancellable:
type: boolean
userID:
type: number
title:
type: string
subtitle:
type: string
progress:
type: number
Context:
type: object
properties:
librarySectionID:
type: string
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/activities/{activityUUID}':
delete:
tags:
- Activities
summary: Cancel Server Activities
description: Cancel Server Activities
operationId: cancelServerActivities
parameters:
- name: activityUUID
description: The UUID of the activity to cancel.
in: path
schema:
type: string
example: 25b71ed5-0f9d-461c-baa7-d404e9e10d3e
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The Server Activity was canceled
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/updater/status:
get:
tags:
- Updater
summary: Querying status of updates
description: Querying status of updates
operationId: queryUpdateStatus
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The Server Updates
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/updater/check:
put:
tags:
- Updater
summary: Checking for updates
description: Checking for updates
operationId: checkForUpdates
parameters:
- name: download
description: Indicate that you want to start download any updates found.
required: false
in: query
schema:
enum:
- 0
- 1
example: 1
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: ''
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/updater/apply:
put:
tags:
- Updater
summary: Apply Updates
description: |
Note that these two parameters are effectively mutually exclusive. The `tonight` parameter takes precedence and `skip` will be ignored if `tonight` is also passed
operationId: applyUpdates
parameters:
- name: tonight
description: Indicate that you want the update to run during the next Butler execution. Omitting this or setting it to false indicates that the update should install
required: false
in: query
schema:
enum:
- 0
- 1
example: 1
- name: skip
description: Indicate that the latest version should be marked as skipped. The <Release> entry for this version will have the `state` set to `skipped`.
required: false
in: query
schema:
enum:
- 0
- 1
example: 1
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: If the update process started correctly
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'500':
description: If the update process failed to start
/butler:
post:
tags:
- Butler
summary: Start all Butler tasks
description: |
This endpoint will attempt to start all Butler tasks that are enabled in the settings. Butler tasks normally run automatically during a time window configured on the server's Settings page but can be manually started using this endpoint. Tasks will run with the following criteria:
1. Any tasks not scheduled to run on the current day will be skipped.
2. If a task is configured to run at a random time during the configured window and we are outside that window, the task will start immediately.
3. If a task is configured to run at a random time during the configured window and we are within that window, the task will be scheduled at a random time within the window.
4. If we are outside the configured window, the task will start immediately.
operationId: startAllTasks
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: All tasks were started
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
delete:
tags:
- Butler
summary: Stop all Butler tasks
description: |
This endpoint will stop all currently running tasks and remove any scheduled tasks from the queue.
operationId: stopAllTasks
responses:
'200':
description: All tasks were stopped
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/butler/{taskName}':
post:
tags:
- Butler
summary: Start a single Butler task
description: |
This endpoint will attempt to start a single Butler task that is enabled in the settings. Butler tasks normally run automatically during a time window configured on the server's Settings page but can be manually started using this endpoint. Tasks will run with the following criteria:
1. Any tasks not scheduled to run on the current day will be skipped.
2. If a task is configured to run at a random time during the configured window and we are outside that window, the task will start immediately.
3. If a task is configured to run at a random time during the configured window and we are within that window, the task will be scheduled at a random time within the window.
4. If we are outside the configured window, the task will start immediately.
operationId: startTask
parameters:
- name: taskName
description: the name of the task to be started.
in: path
schema:
type: string
enum:
- BackupDatabase
- BuildGracenoteCollections
- CheckForUpdates
- CleanOldBundles
- CleanOldCacheFiles
- DeepMediaAnalysis
- GenerateAutoTags
- GenerateChapterThumbs
- GenerateMediaIndexFiles
- OptimizeDatabase
- RefreshLibraries
- RefreshLocalMedia
- RefreshPeriodicMetadata
- UpgradeMediaAnalysis
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The task was started successfully
'202':
description: The task was already running.
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
delete:
tags:
- Butler
summary: Stop a single Butler task
description: |
This endpoint will stop a currently running task by name, or remove it from the list of scheduled tasks if it exists. See the section above for a list of task names for this endpoint.
operationId: stopTask
parameters:
- name: taskName
description: The name of the task to be started.
in: path
schema:
type: string
enum:
- BackupDatabase
- BuildGracenoteCollections
- CheckForUpdates
- CleanOldBundles
- CleanOldCacheFiles
- DeepMediaAnalysis
- GenerateAutoTags
- GenerateChapterThumbs
- GenerateMediaIndexFiles
- OptimizeDatabase
- RefreshLibraries
- RefreshLocalMedia
- RefreshPeriodicMetadata
- UpgradeMediaAnalysis
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The task was stopped
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'404':
description: The task was not running
/log:
get:
tags:
- Log
summary: Logging a single line message.
description: |
This endpoint will write a single-line log message, including a level and source to the main Plex Media Server log.
operationId: logLine
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
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Log Line submitted successfully
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
post:
tags:
- Log
summary: Logging a multi-line message
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: logMultiLine
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
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.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/log/networked:
get:
tags:
- Log
summary: Enabling Papertrail
description: |
This endpoint will enable all Plex Media Serverlogs to be sent to the Papertrail networked logging site for a period of time.
operationId: enablePaperTrail
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Papertrail enabled successfully
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'403':
description: the user was not signed in
/security/token:
get:
tags:
- Security
summary: Get a Transient Token.
description: |
This endpoint provides the caller with a temporary token with the same access level as the caller's token. These tokens are valid for up to 48 hours and are destroyed if the server instance is restarted.
operationId: getTransientToken
parameters:
- name: type
description: '`delegation` - This is the only supported `type` parameter.'
in: query
schema:
type: string
enum:
- delegation
required: true
- name: scope
description: '`all` - This is the only supported `scope` parameter.'
in: query
schema:
type: string
enum:
- all
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: A Transient Token
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/security/resources:
get:
tags:
- Security
summary: Get Source Connection Information
description: |
If a caller requires connection details and a transient token for a source that is known to the server, for example a cloud media provider or shared PMS, then this endpoint can be called. This endpoint is only accessible with either an admin token or a valid transient token generated from an admin token.
Note: requires Plex Media Server >= 1.15.4.
operationId: getSourceConnectionInformation
parameters:
- name: source
description: The source identifier with an included prefix.
in: query
schema:
type: string
example:
- 'server://client-identifier'
- 'provider://provider-identifier'
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Source Connection Information
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/library/sections/{sectionId}/all':
get:
tags:
- Library
summary: Get Library Items
description: |
This endpoint will return a list of library items filtered by the filter and type provided
operationId: getLibraryItems
parameters:
- name: sectionId
description: the Id of the library to query
in: path
schema:
type: number
required: true
- name: type
description: item type
in: query
schema:
type: number
required: false
- name: filter
description: the filter parameter
in: query
schema:
type: string
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The details of the library
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/library/sections/{sectionId}/refresh':
get:
tags:
- Library
summary: Refresh Library
description: |
This endpoint Refreshes the library.
operationId: refreshLibrary
parameters:
- name: sectionId
description: the Id of the library to refresh
in: path
schema:
type: number
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The library is refreshing
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/library/sections/{sectionId}/latest':
get:
tags:
- Library
summary: Get Latest Library Items
description: |
This endpoint will return a list of the latest library items filtered by the filter and type provided
operationId: getLatestLibraryItems
parameters:
- name: sectionId
description: the Id of the library to query
in: path
schema:
type: number
required: true
- name: type
description: item type
in: query
schema:
type: number
required: true
- name: filter
description: the filter parameter
in: query
schema:
type: string
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The details of the library
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/library/sections/{sectionId}/common':
get:
tags:
- Library
summary: Get Common Library Items
description: |
Represents a "Common" item. It contains only the common attributes of the items selected by the provided filter
operationId: getCommonLibraryItems
parameters:
- name: sectionId
description: the Id of the library to query
in: path
schema:
type: number
required: true
- name: type
description: item type
in: query
schema:
type: number
required: true
- name: filter
description: the filter parameter
in: query
schema:
type: string
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The details of the library
'400':
description: In response to missing the type parameter.
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'404':
description: In response to a non-existant sectionId.
'/library/sections/{sectionId}':
get:
tags:
- Library
summary: Get Library Details
description: |
Returns details for the library. This can be thought of as an interstitial endpoint because it contains information about the library, rather than content itself. These details are:
- A list of `Directory` objects: These used to be used by clients to build a menuing system. There are four flavors of directory found here:
- Primary: (e.g. all, On Deck) These are still used in some clients to provide "shortcuts" to subsets of media. However, with the exception of On Deck, all of them can be created by media queries, and the desire is to allow these to be customized by users.
- Secondary: These are marked with `secondary="1"` and were used by old clients to provide nested menus allowing for primative (but structured) navigation.
- Special: There is a By Folder entry which allows browsing the media by the underlying filesystem structure, and there's a completely obsolete entry marked `search="1"` which used to be used to allow clients to build search dialogs on the fly.
- A list of `Type` objects: These represent the types of things found in this library, and for each one, a list of `Filter` and `Sort` objects. These can be used to build rich controls around a grid of media to allow filtering and organizing. Note that these filters and sorts are optional, and without them, the client won't render any filtering controls. The `Type` object contains:
- `key`: This provides the root endpoint returning the actual media list for the type.
- `type`: This is the metadata type for the type (if a standard Plex type).
- `title`: The title for for the content of this type (e.g. "Movies").
- Each `Filter` object contains a description of the filter. Note that it is not an exhaustive list of the full media query language, but an inportant subset useful for top-level API.
- `filter`: This represents the filter name used for the filter, which can be used to construct complex media queries with.
- `filterType`: This is either `string`, `integer`, or `boolean`, and describes the type of values used for the filter.
- `key`: This provides the endpoint where the possible range of values for the filter can be retrieved (e.g. for a "Genre" filter, it returns a list of all the genres in the library). This will include a `type` argument that matches the metadata type of the Type element.
- `title`: The title for the filter.
- Each `Sort` object contains a description of the sort field.
- `defaultDirection`: Can be either `asc` or `desc`, and specifies the default direction for the sort field (e.g. titles default to alphabetically ascending).
- `descKey` and `key`: Contains the parameters passed to the `sort=...` media query for each direction of the sort.
- `title`: The title of the field.
operationId: getLibraryDetails
parameters:
- name: sectionId
description: the Id of the library to query
in: path
schema:
type: string
example: 1000
required: true
- name: includeDetails
description: |
Whether or not to include details for a section (types, filters, and sorts).
Only exists for backwards compatibility, media providers other than the server libraries have it on always.
in: query
schema:
type: number
enum:
- 0
- 1
default: 0
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The details of the library
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/library/sections:
get:
tags:
- Library
summary: Get All Libraries
operationId: getLibraries
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
description: |
A library section (commonly referred to as just a library) is a collection of media.
Libraries are typed, and depending on their type provide either a flat or a hierarchical view of the media.
For example, a music library has an artist > albums > tracks structure, whereas a movie library is flat.
Libraries have features beyond just being a collection of media; for starters, they include information about supported types, filters and sorts.
This allows a client to provide a rich interface around the media (e.g. allow sorting movies by release year).
responses:
'200':
description: The libraries available on the Server
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/library/hashes:
get:
tags:
- Hashes
summary: Get Hash Value
description: This resource returns hash values for local files
operationId: getFileHash
parameters:
- name: url
description: 'This is the path to the local file, must be prefixed by `file://`'
in: query
schema:
type: string
example: 'file://C:\Image.png&type=13'
required: true
- name: type
description: Item type
in: query
schema:
type: number
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The hash of the file
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/library/onDeck:
get:
tags:
- Library
summary: Get On Deck
description: |
This endpoint will return the on deck content.
operationId: getOnDeck
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The on deck content
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/hubs:
get:
tags:
- Hubs
summary: Get Global Hubs
description: ''
operationId: getGlobalHubs
parameters:
- name: count
description: The number of items to return with each hub.
in: query
schema:
type: number
required: false
- name: onlyTransient
description: 'Only return hubs which are "transient", meaning those which are prone to changing after media playback or addition (e.g. On Deck, or Recently Added).'
in: query
schema:
type: number
enum:
- 0
- 1
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: returns global hubs
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/hubs/sections/{sectionId}':
get:
tags:
- Hubs
summary: Get library specific hubs
description: |
This endpoint will return a list of library specific hubs
operationId: getLibraryHubs
parameters:
- name: sectionId
description: the Id of the library to query
in: path
schema:
type: number
required: true
- name: count
description: The number of items to return with each hub.
in: query
schema:
type: number
required: false
- name: onlyTransient
description: 'Only return hubs which are "transient", meaning those which are prone to changing after media playback or addition (e.g. On Deck, or Recently Added).'
in: query
schema:
type: number
enum:
- 0
- 1
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The hubs specific to the library
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/playlists/all:
get:
tags:
- Playlists
summary: Get All Playlists
description: ''
operationId: getPlaylists
parameters:
- name: playlistType
description: limit to a type of playlist.
in: query
schema:
type: string
enum:
- audio
- video
- photo
required: false
- name: smart
description: type of playlists to return (default is all).
in: query
schema:
type: number
enum:
- 0
- 1
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: returns all playlists
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/playlists:
post:
tags:
- Playlists
summary: Create a Playlist
description: |
Create a new playlist. By default the playlist is blank. To create a playlist along with a first item, pass:
- `uri` - The content URI for what we're playing (e.g. `library://...`).
- `playQueueID` - To create a playlist from an existing play queue.
operationId: createPlaylist
parameters:
- name: title
description: name of the playlist
in: query
schema:
type: string
required: true
- name: type
description: type of playlist to create
in: query
schema:
type: string
enum:
- audio
- video
- photo
required: true
- name: smart
description: whether the playlist is smart or not
in: query
schema:
type: number
enum:
- 0
- 1
required: true
- name: uri
description: the content URI for the playlist
in: query
schema:
type: string
required: false
- name: playQueueID
description: the play queue to copy to a playlist
in: query
schema:
type: number
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: returns all playlists
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/playlists/{playlistID}':
get:
tags:
- Playlists
summary: Retrieve Playlist
description: |
Gets detailed metadata for a playlist. A playlist for many purposes (rating, editing metadata, tagging), can be treated like a regular metadata item:
Smart playlist details contain the `content` attribute. This is the content URI for the generator. This can then be parsed by a client to provide smart playlist editing.
operationId: getPlaylist
parameters:
- name: playlistID
description: the ID of the playlist
in: path
schema:
type: number
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The playlist
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
delete:
tags:
- Playlists
summary: Deletes a Playlist
description: |
This endpoint will delete a playlist
operationId: deletePlaylist
parameters:
- name: playlistID
description: the ID of the playlist
in: path
schema:
type: number
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The playlist is deleted
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
put:
tags:
- Playlists
summary: Update a Playlist
description: |
From PMS version 1.9.1 clients can also edit playlist metadata using this endpoint as they would via `PUT /library/metadata/{playlistID}`
operationId: updatePlaylist
parameters:
- name: playlistID
description: the ID of the playlist
in: path
schema:
type: number
required: true
responses:
'200':
description: The playlist is deleted
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/playlists/{playlistID}/items':
get:
tags:
- Playlists
summary: Retrieve Playlist Contents
description: |
Gets the contents of a playlist. Should be paged by clients via standard mechanisms.
By default leaves are returned (e.g. episodes, movies). In order to return other types you can use the `type` parameter.
For example, you could use this to display a list of recently added albums vis a smart playlist.
Note that for dumb playlists, items have a `playlistItemID` attribute which is used for deleting or moving items.
operationId: getPlaylistContents
parameters:
- name: playlistID
description: the ID of the playlist
in: path
schema:
type: number
required: true
- name: type
description: the metadata type of the item to return
in: query
schema:
type: number
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The playlist contents
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
delete:
tags:
- Playlists
summary: Delete Playlist Contents
description: |
Clears a playlist, only works with dumb playlists. Returns the playlist.
operationId: clearPlaylistContents
parameters:
- name: playlistID
description: the ID of the playlist
in: path
schema:
type: number
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The playlist contents are cleared
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
put:
tags:
- Playlists
summary: Adding to a Playlist
description: |
Adds a generator to a playlist, same parameters as the POST above. With a dumb playlist, this adds the specified items to the playlist.
With a smart playlist, passing a new `uri` parameter replaces the rules for the playlist. Returns the playlist.
operationId: addPlaylistContents
parameters:
- name: playlistID
description: the ID of the playlist
in: path
schema:
type: number
required: true
- name: uri
description: the content URI for the playlist
in: query
schema:
type: string
example: 'library://..'
required: true
- name: playQueueID
description: the play queue to add to a playlist
in: query
schema:
type: number
example: 123
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Playlist Updated
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/playlists/upload:
post:
tags:
- Playlists
summary: Upload Playlist
description: |
Imports m3u playlists by passing a path on the server to scan for m3u-formatted playlist files, or a path to a single playlist file.
operationId: uploadPlaylist
parameters:
- name: path
description: |
absolute path to a directory on the server where m3u files are stored, or the absolute path to a playlist file on the server.
If the `path` argument is a directory, that path will be scanned for playlist files to be processed.
Each file in that directory creates a separate playlist, with a name based on the filename of the file that created it.
The GUID of each playlist is based on the filename.
If the `path` argument is a file, that file will be used to create a new playlist, with the name based on the filename of the file that created it.
The GUID of each playlist is based on the filename.
in: query
schema:
type: string
example: /home/barkley/playlist.m3u
required: true
- name: force
description: |
force overwriting of duplicate playlists. By default, a playlist file uploaded with the same path will overwrite the existing playlist.
The `force` argument is used to disable overwriting. If the `force` argument is set to 0, a new playlist will be created suffixed with the date and time that the duplicate was uploaded.
in: query
schema:
type: number
enum:
- 0
- 1
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The playlist is uploaded
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/hubs/search:
get:
tags:
- Search
summary: Perform a search
operationId: performSearch
description: |
This endpoint performs a search across all library sections, or a single section, and returns matches as hubs, split up by type. It performs spell checking, looks for partial matches, and orders the hubs based on quality of results. In addition, based on matches, it will return other related matches (e.g. for a genre match, it may return movies in that genre, or for an actor match, movies with that actor).
In the response's items, the following extra attributes are returned to further describe or disambiguate the result:
- `reason`: The reason for the result, if not because of a direct search term match; can be either:
- `section`: There are multiple identical results from different sections.
- `originalTitle`: There was a search term match from the original title field (sometimes those can be very different or in a foreign language).
- `<hub identifier>`: If the reason for the result is due to a result in another hub, the source hub identifier is returned. For example, if the search is for "dylan" then Bob Dylan may be returned as an artist result, an a few of his albums returned as album results with a reason code of `artist` (the identifier of that particular hub). Or if the search is for "arnold", there might be movie results returned with a reason of `actor`
- `reasonTitle`: The string associated with the reason code. For a section reason, it'll be the section name; For a hub identifier, it'll be a string associated with the match (e.g. `Arnold Schwarzenegger` for movies which were returned because the search was for "arnold").
- `reasonID`: The ID of the item associated with the reason for the result. This might be a section ID, a tag ID, an artist ID, or a show ID.
This request is intended to be very fast, and called as the user types.
parameters:
- name: query
description: The query term
in: query
schema:
type: string
example:
- arnold
- dylan
required: true
- name: sectionId
description: 'This gives context to the search, and can result in re-ordering of search result hubs'
in: query
schema:
type: number
required: false
- name: limit
description: The number of items to return per hub
in: query
schema:
type: number
example: 5
default: 3
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The search results
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/hubs/search/voice:
get:
tags:
- Search
summary: Perform a voice search
operationId: performVoiceSearch
description: |
This endpoint performs a search specifically tailored towards voice or other imprecise input which may work badly with the substring and spell-checking heuristics used by the `/hubs/search` endpoint.
It uses a [Levenshtein distance](https://en.wikipedia.org/wiki/Levenshtein_distance) heuristic to search titles, and as such is much slower than the other search endpoint.
Whenever possible, clients should limit the search to the appropriate type.
Results, as well as their containing per-type hubs, contain a `distance` attribute which can be used to judge result quality.
parameters:
- name: query
description: The query term
in: query
schema:
type: string
example:
- dead+poop
required: true
- name: sectionId
description: 'This gives context to the search, and can result in re-ordering of search result hubs'
in: query
schema:
type: number
required: false
- name: limit
description: The number of items to return per hub
in: query
schema:
type: number
example: 5
default: 3
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The search results
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/status/sessions:
get:
tags:
- Sessions
summary: Get Active Sessions
description: This will retrieve the "Now Playing" Information of the PMS.
operationId: getSessions
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: List of Active Plex Sessions
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/status/sessions/history/all:
get:
tags:
- Sessions
summary: Get Session History
description: This will Retrieve a listing of all history views.
operationId: getSessionHistory
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: List of Plex Sessions
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
'/:/prefs':
get:
tags:
- Server
summary: Get Server Preferences
description: Get Server Preferences
operationId: getServerPreferences
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Server Preferences
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/user:
servers:
- url: 'https://plex.tv/api/v2'
get:
tags:
- User
summary: Get Logged in User
description: Get Logged in User
operationId: getUserDetails
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Logged in user details
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/resources:
servers:
- url: 'https://plex.tv/api/v2'
get:
tags:
- Devices
summary: Get Devices
description: Get Devices
operationId: getDevices
parameters:
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: List of Plex Devices
content:
application/json:
schema:
type: array
items:
type: object
properties:
name:
type: string
example: Hera
product:
type: string
example: Plex Media Server
productVersion:
type: string
example: 1.31.3.6868-28fc46b27
platform:
type: string
example: Linux
platformVersion:
type: string
example: '5.19.17-Unraid (#2 SMP PREEMPT_DYNAMIC Wed Nov 2 11:54:15 PDT 2022)'
device:
type: string
example: PC
clientIdentifier:
type: string
example: 96f2fe7a78c9dc1f16a16bedbe90f98149be16b4
createdAt:
type: string
format: date-time
example: 2022-06-02T00:54:26.000Z
lastSeenAt:
type: string
format: date-time
example: 2023-04-11T05:53:59.000Z
provides:
type: string
example: server
ownerId:
type: string
format: nullable
sourceTitle:
type: string
format: nullable
publicAddress:
type: string
example: 68.248.140.20
accessToken:
type: string
example: CR3nxzsaSHdWx_WwZsJL
owned:
type: boolean
home:
type: boolean
synced:
type: boolean
relay:
type: boolean
presence:
type: boolean
httpsRequired:
type: boolean
publicAddressMatches:
type: boolean
dnsRebindingProtection:
type: boolean
natLoopbackSupported:
type: boolean
connections:
type: array
items:
type: object
properties:
protocol:
type: string
example: http
address:
type: string
example: 172.18.0.1
port:
type: number
example: 32400
uri:
type: string
example: 'http://172.18.0.1:32400'
local:
type: boolean
relay:
type: boolean
IPv6:
type: boolean
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
/pins:
servers:
- url: 'https://plex.tv/api/v2'
post:
tags:
- Authentication
summary: Get a Pin
operationId: getPin
description: Retrieve a Pin from Plex.tv for authentication flows
security:
- PlexClientIdentifier:
type: apiKey
in: header
name: X-Plex-Client-Identifier
parameters:
- name: strong
description: |
Determines the kind of code returned by the API call
Strong codes are used for Pin authentication flows
Non-Strong codes are used for `Plex.tv/link`
in: query
schema:
type: boolean
default: false
required: false
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: The Pin
content:
application/json:
schema:
type: object
properties:
id:
description: PinID for use with authentication
type: number
example: 1272322473
code:
type: string
example: 3patfx1a78ukcbr7x0n9bl26t
product:
type: string
example: Plex Web
trusted:
type: boolean
qr:
description: |
a link to a QR code hosted on plex.tv
The QR code redirects to the relevant `plex.tv/link` authentication page
Which then prompts the user for the 4 Digit Link Pin
type: string
example: 'https://plex.tv/api/v2/pins/qr/3patfx1a78ukcbr7x0n9bl26t'
clientIdentifier:
type: string
example: Postman
location:
type: object
properties:
code:
type: string
example: US
european_union_member:
type: boolean
continent_code:
type: string
example: NA
country:
type: string
example: United States
city:
type: string
example: Austin
time_zone:
type: string
example: America/Chicago
postal_code:
type: string
example: 78732
in_privacy_restricted_country:
type: boolean
subdivisions:
type: string
example: Texas
coordinates:
type: string
example: 30.3768 -97.8935
expiresIn:
type: number
example: 1800
createdAt:
type: string
format: date-time
example: 2023-04-12T17:00:03.000Z
expiresAt:
type: string
format: date-time
example: 2023-04-12T17:30:03.000Z
authToken:
type: string
format: nullable
newRegistration:
type: string
format: nullable
'400':
description: X-Plex-Client-Identifier is missing
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1000
message:
type: string
example: X-Plex-Client-Identifier is missing
status:
type: number
example: 400
'/pins/{pinID}':
servers:
- url: 'https://plex.tv/api/v2'
get:
tags:
- Authentication
summary: Get Access Token
operationId: getToken
description: Retrieve an Access Token from Plex.tv after the Pin has already been authenticated
security:
- PlexClientIdentifier:
type: apiKey
in: header
name: X-Plex-Client-Identifier
parameters:
- name: pinID
description: The PinID to retrieve an access token for
in: path
schema:
type: string
required: true
- in: header
name: X-Plex-Device-Name
description: Primary name for the device eg. `Plex Web (Chrome)`
schema:
type: string
example: Plex Web (Chrome)
required: false
- in: header
name: X-Plex-Device
description: |
The type of device your application is running on
Device name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`
schema:
type: string
example:
- 'iPhone3,2'
- Motorola XOOM™
- LG5200TV
required: false
- in: header
name: X-Plex-Platform-Version
description: 'Operating system version, eg `4.3.1`, `10.6.7`, `3.2`'
schema:
type: string
example:
- 4.3.1
- 10.6.7
- 3.2
required: false
- in: header
name: X-Plex-Platform
description: 'Platform name, eg `Web`, `iOS`, `MacOSX`, `Android`, `LG`'
schema:
type: string
example:
- Web
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Product
description: 'Plex application name, eg `Laika`, `Plex Media Server`, `Media Link`'
schema:
type: string
example:
- Laika
- Plex Media Server
- Media Link
required: false
- in: header
name: X-Plex-Provides
description: 'One or more of `[player, controller, server]`'
schema:
type: string
example:
- iOS
- MacOSX
- Android
- LG
required: false
- in: header
name: X-Plex-Version
description: Your application version number
schema:
type: string
required: false
responses:
'200':
description: Access Token
'401':
description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
content:
application/json:
schema:
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: number
example: 1001
message:
type: string
example: User could not be authenticated
status:
type: number
example: 401
tags:
- name: Activities
description: |
Activities are awesome. They provide a way to monitor and control asynchronous operations on the server. In order to receive real-time updates for activities, a client would normally subscribe via either EventSource or Websocket endpoints.
Activities are associated with HTTP replies via a special `X-Plex-Activity` header which contains the UUID of the activity.
Activities are optional cancellable. If cancellable, they may be cancelled via the `DELETE` endpoint. Other details:
- They can contain a `progress` (from 0 to 100) marking the percent completion of the activity.
- They must contain an `type` which is used by clients to distinguish the specific activity.
- They may contain a `Context` object with attributes which associate the activity with various specific entities (items, libraries, etc.)
- The may contain a `Response` object which attributes which represent the result of the asynchronous operation.
- name: Authentication
description: |
API Calls regarding authentication for Plex Media Server
- name: Butler
description: |
Butler is the task manager of the Plex Media Server Ecosystem.
- name: Server
description: |
Operations against the Plex Media Server System.
- name: Updater
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
- name: Security
description: |
API Calls against Security for Plex Media Server
- name: Library
description: |
API Calls interacting with Plex Media Server Libraries
- name: Hubs
description: |
Hubs are a structured two-dimensional container for media, generally represented by multiple horizontal rows.
- name: Playlists
description: |
Playlists are ordered collections of media. They can be dumb (just a list of media) or smart (based on a media query, such as "all albums from 2017").
They can be organized in (optionally nesting) folders.
Retrieving a playlist, or its items, will trigger a refresh of its metadata.
This may cause the duration and number of items to change.
- name: Search
description: |
API Calls that perform search operations with Plex Media Server
- name: User
description: |
API Calls that perform operations with Plex Media Server Users
Reference in New Issue View Git Blame Copy Permalink