openapi: 3.0.3info:title: Navidrome APIversion: 1.0.0description: |Navidrome API v1. Spec-first, additive within v1. Clients discover implementedcapability modules through `GET /server` and never sniff versions.Enums are open: new values may be added to any enum within v1. Clients mustaccept values they do not recognise instead of failing.Every operation declares `x-stability-level`: `alpha` operations may change ordisappear without notice, `beta` and `stable` operations only change additively.A level is only ever raised, never lowered.`HEAD` is accepted wherever `GET` is. A `405` response lists the allowed methodsin its `Allow` header.license:name: GPL-3.0url: https://www.gnu.org/licenses/gpl-3.0.htmlservers:- url: /api/v1tags:- name: serverdescription: Server discovery and the published OpenAPI document.paths:/server:$ref: ./paths/server.yaml/openapi.json:$ref: ./paths/openapi.yaml#/json/openapi.yaml:$ref: ./paths/openapi.yaml#/yamlcomponents:securitySchemes:bearerAuth:type: httpscheme: bearerbearerFormat: JWTdescription: Short-lived access token minted from a device grant. Not yet applied to any operation.