jellyfin-api

name	jellyfin-api
description	Reference for the Jellyfin REST API. Use when adding, debugging, or extending Jellyfin API calls (server queries, library/item lookups, playback control, response schemas).

Jellyfin API

Fetch the Jellyfin OpenAPI spec from:

https://api.jellyfin.org/openapi/jellyfin-openapi-stable.json

Jellyfin paths are not version-prefixed (e.g. /Items, /Users/{userId}/Items, /System/Info). Multiple auth schemes are supported — consult components.securitySchemes in the spec before assuming a header format.

The spec is large (~2 MB) — never load it whole into context. Use curl + jq to extract only what you need:

• List all paths: curl -s <url> | jq '.paths | keys'
• Inspect one endpoint: curl -s <url> | jq '.paths."/Items"'
• Look up a schema: curl -s <url> | jq '.components.schemas.BaseItemDto'
• Find endpoints by tag: curl -s <url> | jq '[.paths | to_entries[] | select(.value | .. | .tags? // [] | index("Items")) | .key]'
• Check auth schemes: curl -s <url> | jq '.components.securitySchemes'