> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/jellyfin/jellyfin/llms.txt > Use this file to discover all available pages before exploring further. # Server Configuration > API endpoints for managing Jellyfin server configuration ## Overview The Server Configuration API provides endpoints to retrieve and update server configuration settings. These endpoints allow administrators to manage server behavior, metadata options, branding, and other system-wide settings. ## Get Server Configuration Retrieves the complete server configuration. ### Endpoint ``` GET /System/Configuration ``` ### Authentication Required. Any authenticated user can retrieve the configuration. ### Response Returns a `ServerConfiguration` object with all server settings. The name of the server Whether to enable Prometheus metrics exporting Whether Quick Connect is available for use The path where metadata is stored The preferred language for metadata The country code for metadata The UI culture/locale Minimum percentage of an item that must be played to update playstate Maximum percentage that can be played while still saving playstate Minimum duration (in seconds) for an item to be eligible for playstate updates Minimum minutes of an audiobook that must be played to update playstate Remaining minutes of an audiobook that can be played while still saving playstate Threshold in minutes after which inactive sessions are closed (0 to disable) Delay in seconds to wait after filesystem changes before discovering additions/removals Duration in seconds to wait after library update before executing notification Maximum number of items to cache Metadata configuration for different item types Bitrate limit for remote clients Whether to enable folder view Whether to group movies into collections Whether to group TV shows into collections Whether to display special episodes within seasons Whether to include external content in suggestions Whether to log slow server responses as warnings Threshold for slow response time warning (in milliseconds) Array of allowed CORS hosts Number of days to retain activity logs How the library scan fans out for concurrent operations How many metadata refreshes can run concurrently Whether clients are allowed to upload logs Dummy chapter duration in seconds (0 or less to disable) Resolution for chapter images Limit for parallel image encoding List of cast receiver applications Configuration for trickplay (preview thumbnails) Whether to enable old authorization methods ### Example Request ```bash theme={null} curl -X GET "https://your-jellyfin-server/System/Configuration" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Example Response ```json theme={null} { "ServerName": "My Jellyfin Server", "EnableMetrics": false, "QuickConnectAvailable": true, "MetadataPath": "/config/metadata", "PreferredMetadataLanguage": "en", "MetadataCountryCode": "US", "UICulture": "en-US", "MinResumePct": 5, "MaxResumePct": 90, "MinResumeDurationSeconds": 300, "LibraryMonitorDelay": 60, "EnableFolderView": false, "DisplaySpecialsWithinSeasons": true, "CorsHosts": ["*"], "ActivityLogRetentionDays": 30, "AllowClientLogUpload": true } ``` ### Response Codes * `200` - Configuration retrieved successfully *** ## Update Server Configuration Updates the complete server configuration. ### Endpoint ``` POST /System/Configuration ``` ### Authentication Required. User must have elevated permissions (administrator). ### Request Body Send a complete `ServerConfiguration` object with the desired settings. Complete ServerConfiguration object with updated values ### Example Request ```bash theme={null} curl -X POST "https://your-jellyfin-server/System/Configuration" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "ServerName": "My Updated Server", "EnableMetrics": true, "PreferredMetadataLanguage": "en", "MetadataCountryCode": "US", "MinResumePct": 5, "MaxResumePct": 90 }' ``` ### Response Codes * `204` - Configuration updated successfully * `403` - User does not have permission to update configuration *** ## Get Named Configuration Retrieves a specific named configuration section. ### Endpoint ``` GET /System/Configuration/{key} ``` ### Authentication Required. ### Path Parameters The configuration key/section name (e.g., "branding", "encoding") ### Response Returns the configuration object for the specified key. ### Example Request ```bash theme={null} curl -X GET "https://your-jellyfin-server/System/Configuration/branding" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Example Response ```json theme={null} { "LoginDisclaimer": "Welcome to My Jellyfin Server", "CustomCss": "", "SplashscreenEnabled": false } ``` ### Response Codes * `200` - Configuration retrieved successfully *** ## Update Named Configuration Updates a specific named configuration section. ### Endpoint ``` POST /System/Configuration/{key} ``` ### Authentication Required. User must have elevated permissions (administrator). ### Path Parameters The configuration key/section name ### Request Body Configuration object with updated values ### Example Request ```bash theme={null} curl -X POST "https://your-jellyfin-server/System/Configuration/branding" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "LoginDisclaimer": "Welcome!", "CustomCss": "body { background-color: #000; }", "SplashscreenEnabled": true }' ``` ### Response Codes * `204` - Configuration updated successfully * `403` - User does not have permission to update configuration *** ## Get Default Metadata Options Retrieves the default MetadataOptions object. ### Endpoint ``` GET /System/Configuration/MetadataOptions/Default ``` ### Authentication Required. User must have elevated permissions (administrator). ### Response Returns a default `MetadataOptions` object. ### Example Request ```bash theme={null} curl -X GET "https://your-jellyfin-server/System/Configuration/MetadataOptions/Default" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" ``` ### Example Response ```json theme={null} { "ItemType": "", "DisabledMetadataSavers": [], "LocalMetadataReaderOrder": [], "DisabledMetadataFetchers": [], "MetadataFetcherOrder": [], "DisabledImageFetchers": [], "ImageFetcherOrder": [] } ``` ### Response Codes * `200` - Default metadata options retrieved successfully * `403` - User does not have permission *** ## Update Branding Configuration Updates the branding configuration for the server. ### Endpoint ``` POST /System/Configuration/Branding ``` ### Authentication Required. User must have elevated permissions (administrator). ### Request Body Custom text to display on the login page Custom CSS to apply to the web interface Whether to enable the custom splashscreen ### Example Request ```bash theme={null} curl -X POST "https://your-jellyfin-server/System/Configuration/Branding" \ -H "Authorization: MediaBrowser Token=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "LoginDisclaimer": "Welcome to My Custom Server!", "CustomCss": ".header { color: blue; }", "SplashscreenEnabled": true }' ``` ### Response Codes * `204` - Branding configuration updated successfully * `403` - User does not have permission to update branding configuration *** ## Notes * Configuration changes may require a server restart to take full effect * Always retrieve the current configuration before updating to avoid overwriting unintended settings * Some configuration options affect server performance and should be adjusted carefully * Branding configuration updates only modify the specified properties and preserve other settings