> ## 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.

# Persist metadata for an HTTP stream URL

> Used by the player when a remote URL is loaded — saves title/artist/album/duration so the URL can be resolved from the DB later.



## OpenAPI

````yaml /api-reference/openapi.json put /tracks/stream-metadata
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:
  /tracks/stream-metadata:
    put:
      tags:
        - Tracks
      summary: Persist metadata for an HTTP stream URL
      description: >-
        Used by the player when a remote URL is loaded — saves
        title/artist/album/duration so the URL can be resolved from the DB
        later.
      operationId: saveStreamTrackMetadata
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - url
                - title
                - artist
                - album
                - duration_ms
              properties:
                url:
                  type: string
                  format: uri
                title:
                  type: string
                artist:
                  type: string
                album:
                  type: string
                duration_ms:
                  type: integer
                  format: int32
                  minimum: 0
      responses:
        '204':
          description: Stored

````