Jellyfin API

Jellyfin API

API version: v1

Auth

ApiKey X-Emby-Authorization in header

Base URL

http://localhost

Setup

1. Set your API key in the appropriate header
2. GET /System/ActivityLog/Entries -- verify access
3. POST /Auth/Keys -- create first Keys

Endpoints

408 endpoints across 46 groups. See references/api-spec.lap for full details.

System

Auth

Artists

Audio

Branding

Channels

Collections

web

Devices

DisplayPreferences

Dlna

Videos

Environment

Items

Genres

MusicGenres

Persons

Studios

Users

Images

Albums

Playlists

Songs

Libraries

Library

Movies

Shows

Trailers

LiveTv

Localization

LiveStreams

Playback

Notifications

Packages

Repositories

Sessions

Plugins

QuickConnect

ScheduledTasks

Search

Startup

FallbackFont

Providers

SyncPlay

GetUtcTime

Years

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "List all Entries?" -> GET /System/ActivityLog/Entries
• "List all Keys?" -> GET /Auth/Keys
• "Create a Key?" -> POST /Auth/Keys
• "Delete a Key?" -> DELETE /Auth/Keys/{key}
• "List all Artists?" -> GET /Artists
• "Get Artist details?" -> GET /Artists/{name}
• "List all AlbumArtists?" -> GET /Artists/AlbumArtists
• "List all stream?" -> GET /Audio/{itemId}/stream
• "Get stream.{container} details?" -> GET /Audio/{itemId}/stream.{container}
• "List all Configuration?" -> GET /Branding/Configuration
• "List all Css?" -> GET /Branding/Css
• "List all Css.css?" -> GET /Branding/Css.css
• "List all Channels?" -> GET /Channels
• "List all Features?" -> GET /Channels/{channelId}/Features
• "List all Items?" -> GET /Channels/{channelId}/Items
• "List all Features?" -> GET /Channels/Features
• "List all Latest?" -> GET /Channels/Items/Latest
• "Create a Collection?" -> POST /Collections
• "Create a Item?" -> POST /Collections/{collectionId}/Items
• "List all Configuration?" -> GET /System/Configuration
• "Create a Configuration?" -> POST /System/Configuration
• "Get Configuration details?" -> GET /System/Configuration/{key}
• "List all Default?" -> GET /System/Configuration/MetadataOptions/Default
• "Create a Path?" -> POST /System/MediaEncoder/Path
• "List all ConfigurationPage?" -> GET /web/ConfigurationPage
• "List all ConfigurationPages?" -> GET /web/ConfigurationPages
• "List all Devices?" -> GET /Devices
• "List all Info?" -> GET /Devices/Info
• "List all Options?" -> GET /Devices/Options
• "Create a Option?" -> POST /Devices/Options
• "Get DisplayPreference details?" -> GET /DisplayPreferences/{displayPreferencesId}
• "List all ProfileInfos?" -> GET /Dlna/ProfileInfos
• "Create a Profile?" -> POST /Dlna/Profiles
• "Get Profile details?" -> GET /Dlna/Profiles/{profileId}
• "Delete a Profile?" -> DELETE /Dlna/Profiles/{profileId}
• "List all Default?" -> GET /Dlna/Profiles/Default
• "List all ConnectionManager?" -> GET /Dlna/{serverId}/ConnectionManager
• "List all ConnectionManager?" -> GET /Dlna/{serverId}/ConnectionManager/ConnectionManager
• "List all ConnectionManager.xml?" -> GET /Dlna/{serverId}/ConnectionManager/ConnectionManager.xml
• "Create a Control?" -> POST /Dlna/{serverId}/ConnectionManager/Control
• "List all ContentDirectory?" -> GET /Dlna/{serverId}/ContentDirectory
• "List all ContentDirectory?" -> GET /Dlna/{serverId}/ContentDirectory/ContentDirectory
• "List all ContentDirectory.xml?" -> GET /Dlna/{serverId}/ContentDirectory/ContentDirectory.xml
• "Create a Control?" -> POST /Dlna/{serverId}/ContentDirectory/Control
• "List all description?" -> GET /Dlna/{serverId}/description
• "List all description.xml?" -> GET /Dlna/{serverId}/description.xml
• "Get icon details?" -> GET /Dlna/{serverId}/icons/{fileName}
• "List all MediaReceiverRegistrar?" -> GET /Dlna/{serverId}/MediaReceiverRegistrar
• "Create a Control?" -> POST /Dlna/{serverId}/MediaReceiverRegistrar/Control
• "List all MediaReceiverRegistrar?" -> GET /Dlna/{serverId}/MediaReceiverRegistrar/MediaReceiverRegistrar
• "List all MediaReceiverRegistrar.xml?" -> GET /Dlna/{serverId}/MediaReceiverRegistrar/MediaReceiverRegistrar.xml
• "Get icon details?" -> GET /Dlna/icons/{fileName}
• "Get hls1 details?" -> GET /Audio/{itemId}/hls1/{playlistId}/{segmentId}.{container}
• "List all main.m3u8?" -> GET /Audio/{itemId}/main.m3u8
• "List all master.m3u8?" -> GET /Audio/{itemId}/master.m3u8
• "Get hls1 details?" -> GET /Videos/{itemId}/hls1/{playlistId}/{segmentId}.{container}
• "List all main.m3u8?" -> GET /Videos/{itemId}/main.m3u8
• "List all master.m3u8?" -> GET /Videos/{itemId}/master.m3u8
• "List all DefaultDirectoryBrowser?" -> GET /Environment/DefaultDirectoryBrowser
• "List all DirectoryContents?" -> GET /Environment/DirectoryContents
• "List all Drives?" -> GET /Environment/Drives
• "List all NetworkShares?" -> GET /Environment/NetworkShares
• "List all ParentPath?" -> GET /Environment/ParentPath
• "Create a ValidatePath?" -> POST /Environment/ValidatePath
• "List all Filters?" -> GET /Items/Filters
• "List all Filters2?" -> GET /Items/Filters2
• "List all Genres?" -> GET /Genres
• "Get Genre details?" -> GET /Genres/{genreName}
• "List all stream.aac?" -> GET /Audio/{itemId}/hls/{segmentId}/stream.aac
• "List all stream.mp3?" -> GET /Audio/{itemId}/hls/{segmentId}/stream.mp3
• "Get hl details?" -> GET /Videos/{itemId}/hls/{playlistId}/{segmentId}.{segmentContainer}
• "List all stream.m3u8?" -> GET /Videos/{itemId}/hls/{playlistId}/stream.m3u8
• "Get Image details?" -> GET /Artists/{name}/Images/{imageType}/{imageIndex}
• "Get Image details?" -> GET /Genres/{name}/Images/{imageType}
• "Get Image details?" -> GET /Genres/{name}/Images/{imageType}/{imageIndex}
• "List all Images?" -> GET /Items/{itemId}/Images
• "Delete a Image?" -> DELETE /Items/{itemId}/Images/{imageType}
• "Get Image details?" -> GET /Items/{itemId}/Images/{imageType}
• "Delete a Image?" -> DELETE /Items/{itemId}/Images/{imageType}/{imageIndex}
• "Get Image details?" -> GET /Items/{itemId}/Images/{imageType}/{imageIndex}
• "Get Image details?" -> GET /Items/{itemId}/Images/{imageType}/{imageIndex}/{tag}/{format}/{maxWidth}/{maxHeight}/{percentPlayed}/{unplayedCount}
• "Create a Index?" -> POST /Items/{itemId}/Images/{imageType}/{imageIndex}/Index
• "Get Image details?" -> GET /MusicGenres/{name}/Images/{imageType}
• "Get Image details?" -> GET /MusicGenres/{name}/Images/{imageType}/{imageIndex}
• "Get Image details?" -> GET /Persons/{name}/Images/{imageType}
• "Get Image details?" -> GET /Persons/{name}/Images/{imageType}/{imageIndex}
• "Get Image details?" -> GET /Studios/{name}/Images/{imageType}
• "Get Image details?" -> GET /Studios/{name}/Images/{imageType}/{imageIndex}
• "Delete a Image?" -> DELETE /Users/{userId}/Images/{imageType}
• "Get Image details?" -> GET /Users/{userId}/Images/{imageType}
• "Get Image details?" -> GET /Users/{userId}/Images/{imageType}/{imageIndex}
• "Delete a Image?" -> DELETE /Users/{userId}/Images/{imageType}/{index}
• "List all General?" -> GET /Images/General
• "Get General details?" -> GET /Images/General/{name}/{type}
• "List all MediaInfo?" -> GET /Images/MediaInfo
• "Get MediaInfo details?" -> GET /Images/MediaInfo/{theme}/{name}
• "List all Ratings?" -> GET /Images/Ratings
• "Get Rating

…(truncated)