/api/server/settings/web

Get or update server-wide configuration settings.

Info

This endpoint requires authentication.

GET
Request

Retrieve the configuration as a authenticated user. By design this route doesn't include certain configuration properties like the datasource, ssl settings, and the core config. None of these options are needed for functionality on the dashboard so they are omitted.

Response

Status: 200 OK

Content-Type: application/json

Returns an object of config and codeMap.

PropertyTypeDescription
configsee belowThe configuration object used for various options around the dashboard.
codeMapsee belowA list of languages and their extensions to be used on /dashboard/upload/file

Example

`{
"config": {
"chunks": {
"max": "95mb",
"size": "80mb",
"enabled": true
},
"tasks": {
"deleteInterval": "30m",
"clearInvitesInterval": "30m",
"maxViewsInterval": "30m",
"thumbnailsInterval": "30s",
"metricsInterval": "30m"
},
"files": {
"route": "/u",
"length": 6,
"defaultFormat": "random",
"disabledExtensions": [],
"maxFileSize": "10gb",
"defaultExpiration": null,
"assumeMimetypes": false,
"defaultDateFormat": "YYYY-MM-DD_HH:mm:ss",
"removeGpsMetadata": true,
"randomWordsNumAdjectives": 2,
"randomWordsSeparator": "-"
},
"urls": {
"route": "/go",
"length": 6
},
"features": {
"imageCompression": true,
"robotsTxt": true,
"healthcheck": true,
"userRegistration": true,
"oauthRegistration": true,
"deleteOnMaxViews": true,
"thumbnails": {
"enabled": true,
"num_threads": 4
},
"metrics": {
"enabled": true,
"adminOnly": false,
"showUserSpecific": true
},
"versionChecking": true,
"versionAPI": "https://zipline-version.diced.sh"
},
"invites": {
"enabled": true,
"length": 6
},
"website": {
"title": "Zipline",
"titleLogo": null,
"externalLinks": [
{
"name": "GitHub",
"url": "https://github.com/diced/zipline"
},
{
"name": "Documentation",
"url": "https://zipline.diced.sh/"
}
],
"loginBackground": null,
"loginBackgroundBlur": true,
"defaultAvatar": null,
"theme": {
"default": "system",
"dark": "builtin:midnight_blue",
"light": "builtin:light_gray"
},
"tos": "/tos.md"
},
"mfa": {
"totp": {
"enabled": false,
"issuer": "Zipline"
},
"passkeys": true
},
"pwa": {
"enabled": false,
"title": "Zipline",
"shortName": "Zipline",
"description": "Zipline",
"themeColor": "#000000",
"backgroundColor": "#000000"
},
"oauthEnabled": {
"discord": true,
"github": false,
"google": false,
"oidc": false
},
"oauth": {
"bypassLocalLogin": false,
"loginOnly": false
}
},
"codeMap": [
{
"ext": "html",
"mime": "text/x-zipline-html",
"name": "HTML"
},
{
"ext": "css",
"mime": "text/x-zipline-css",
"name": "CSS"
},
{
"ext": "cpp",
"mime": "text/x-zipline-c++src",
"name": "C++"
},
{
"ext": "js",
"mime": "text/x-zipline-javascript",
"name": "JavaScript"
},
{
"ext": "py",
"mime": "text/x-zipline-python",
"name": "Python"
},
{
"ext": "rb",
"mime": "text/x-zipline-ruby",
"name": "Ruby"
},
{
"ext": "java",
"mime": "text/x-zipline-java",
"name": "Java"
},
{
"ext": "md",
"mime": "text/x-zipline-markdown",
"name": "Markdown"
},
{
"ext": "c",
"mime": "text/x-zipline-csrc",
"name": "C"
},
{
"ext": "php",
"mime": "text/x-zipline-httpd-php",
"name": "PHP"
},
{
"ext": "sass",
"mime": "text/x-zipline-sass",
"name": "Sass"
},
{
"ext": "scss",
"mime": "text/x-zipline-scss",
"name": "SCSS"
},
{
"ext": "swift",
"mime": "text/x-zipline-swift",
"name": "Swift"
},
{
"ext": "ts",
"mime": "text/x-zipline-typescript",
"name": "TypeScript"
},
{
"ext": "go",
"mime": "text/x-zipline-go",
"name": "Go"
},
{
"ext": "rs",
"mime": "text/x-zipline-rustsrc",
"name": "Rust"
},
{
"ext": "sh",
"mime": "text/x-zipline-sh",
"name": "Bash"
},
{
"ext": "json",
"mime": "text/x-zipline-json",
"name": "JSON"
},
{
"ext": "ps1",
"mime": "text/x-zipline-powershell",
"name": "PowerShell"
},
{
"ext": "sql",
"mime": "text/x-zipline-sql",
"name": "SQL"
},
{
"ext": "yaml",
"mime": "text/x-zipline-yaml",
"name": "YAML"
},
{
"ext": "dockerfile",
"mime": "text/x-zipline-dockerfile",
"name": "Dockerfile"
},
{
"ext": "lua",
"mime": "text/x-zipline-lua",
"name": "Lua"
},
{
"ext": "conf",
"mime": "text/x-zipline-nginx-conf",
"name": "NGINX Config File"
},
{
"ext": "pl",
"mime": "text/x-zipline-perl",
"name": "Perl"
},
{
"ext": "r",
"mime": "text/x-zipline-rsrc",
"name": "R"
},
{
"ext": "scala",
"mime": "text/x-zipline-scala",
"name": "Scala"
},
{
"ext": "groovy",
"mime": "text/x-zipline-groovy",
"name": "Groovy"
},
{
"ext": "kt",
"mime": "text/x-zipline-kotlin",
"name": "Kotlin"
},
{
"ext": "hs",
"mime": "text/x-zipline-haskell",
"name": "Haskell"
},
{
"ext": "ex",
"mime": "text/x-zipline-elixir",
"name": "Elixir"
},
{
"ext": "vim",
"mime": "text/x-zipline-vim",
"name": "Vim"
},
{
"ext": "m",
"mime": "text/x-zipline-matlab",
"name": "MATLAB"
},
{
"ext": "dart",
"mime": "text/x-zipline-dart",
"name": "Dart"
},
{
"ext": "hbs",
"mime": "text/x-zipline-handlebars-template",
"name": "Handlebars"
},
{
"ext": "hcl",
"mime": "text/x-zipline-hcl",
"name": "HCL"
},
{
"ext": "http",
"mime": "text/x-zipline-http",
"name": "HTTP"
},
{
"ext": "ini",
"mime": "text/x-zipline-ini",
"name": "INI"
},
{
"ext": "jsx",
"mime": "text/x-zipline-jsx",
"name": "JSX"
},
{
"ext": "coffee",
"mime": "text/x-zipline-coffeescript",
"name": "CoffeeScript"
},
{
"ext": "tex",
"mime": "text/x-zipline-latex",
"name": "LaTeX (KaTeX)"
},
{
"name": "Plain Text",
"mime": "text/x-zipline-plain",
"ext": "txt"
}
]
}


Last updated: 8/13/2025
Edit this page on GitHub