createPlaylistFolder

Creates a playlist folder.

OpenSubsonic version: 1

OpenSubsonic extension name playlistFolders (As returned by getOpenSubsonicExtensions)

http://your-server/rest/createPlaylistFolder

Creates a playlist folder in the authenticated user’s playlist organization.

Parameters

ParameterReq.OpenS.DefaultComment
nameYesYesThe human-readable name of the playlist folder.
parentIdNoYesID of the parent playlist folder. Omit to create a root-level folder.
sortOrderNoYesPosition among siblings, as a client-assigned integer. If omitted, the server assigns a position after the existing siblings.

A parentId that does not exist or belongs to another user’s tree returns error 70, so that a user cannot probe for folder IDs in other users’ trees. See the extension description for ordering semantics and error handling.

Example

Result

A subsonic-response element with a nested playlistFolder element on success.

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1",
    "type": "AwesomeServerName",
    "serverVersion": "0.1.3 (tag)",
    "openSubsonic": true,
    "playlistFolder": {
      "id": "folder-2026",
      "name": "2026",
      "parentId": "folder-dj",
      "sortOrder": 2
    }
  }
}
Does not exist.