POST
/
playlists
/
upload
using LukeHagar.PlexAPI.SDK;
using LukeHagar.PlexAPI.SDK.Models.Components;
using LukeHagar.PlexAPI.SDK.Models.Requests;

var sdk = new PlexAPI(accessToken: "<YOUR_API_KEY_HERE>");

var res = await sdk.Playlists.UploadPlaylistAsync(
    path: "/home/barkley/playlist.m3u",
    force: QueryParamForce.Zero,
    sectionID: 1
);

// handle response
This response does not have an example.

Authorizations

​
X-Plex-Token
string
header
required

Plex Authentication Token

Query Parameters

​
path
string
required

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.

Example:

"/home/barkley/playlist.m3u"

​
force
enum<integer>
required

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.

Available options:
0,
1
​
sectionID
integer
default:1
required

Possibly the section ID to upload the playlist to, we are not certain.

Example:

1

Response

200
_mintlify/placeholder

The playlist is uploaded

Delete Playlist ContentsGet a Transient Token