> ## Documentation Index
> Fetch the complete documentation index at: https://rockboxzig.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a saved playlist



## OpenAPI

````yaml /api-reference/openapi.json post /saved-playlists
openapi: 3.1.0
info:
  title: Rockbox HTTP API
  version: 1.0.0
  summary: >-
    HTTP REST API for rockboxd — playback, library, playlists, devices,
    settings.
  description: >-
    Rockbox Daemon exposes its full feature surface over HTTP REST on port 6063
    (configurable via `ROCKBOX_TCP_PORT`). It complements the GraphQL API on
    :6062 and the gRPC API on :6061 — all three speak to the same in-process
    state.


    All handlers are defined in `crates/server/src/handlers/` and registered in
    `crates/server/src/lib.rs:run_http_server()`.
  contact:
    name: Rockbox Daemon
    url: https://github.com/tsirysndr/rockboxd
  license:
    name: GPL-2.0
    url: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
servers:
  - url: http://localhost:6063
    description: Default local rockboxd
security: []
tags:
  - name: Albums
  - name: Artists
  - name: Tracks
  - name: Search
  - name: Browse
  - name: Player
  - name: Playlist (queue)
  - name: Saved playlists
  - name: Smart playlists
  - name: Track stats
  - name: Devices
  - name: Settings
  - name: System
  - name: Bluetooth
paths:
  /saved-playlists:
    post:
      tags:
        - Saved playlists
      summary: Create a saved playlist
      operationId: createSavedPlaylist
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                description:
                  type: string
                image:
                  type: string
                folder_id:
                  type: string
                track_ids:
                  type: array
                  items:
                    type: string
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedPlaylist'
        '400':
          description: Missing required fields
components:
  schemas:
    SavedPlaylist:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
          nullable: true
        image:
          type: string
          nullable: true
        folder_id:
          type: string
          nullable: true
        track_count:
          type: integer
          format: int32
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time

````