--- title: settings full: true --- import { Root, API, APIInfo, APIExample, Responses, Response, ResponseTypes, ExampleResponse, TypeScriptResponse, Property, ObjectCollapsible, Requests, Request } from "fumadocs-ui/components/api"; ## settings-reloadServer ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.reloadServer" ``` ```js fetch("http://localhost:3000/api/settings.reloadServer", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-reloadTraefik ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.reloadTraefik" ``` ```js fetch("http://localhost:3000/api/settings.reloadTraefik", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-toggleDashboard ### Authorization "} required={true}> In: `header` ### Request Body | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.toggleDashboard" \ -d '{ "enableDashboard": true }' ``` ```js fetch("http://localhost:3000/api/settings.toggleDashboard", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanUnusedImages ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanUnusedImages" ``` ```js fetch("http://localhost:3000/api/settings.cleanUnusedImages", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanUnusedVolumes ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanUnusedVolumes" ``` ```js fetch("http://localhost:3000/api/settings.cleanUnusedVolumes", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanStoppedContainers ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanStoppedContainers" ``` ```js fetch("http://localhost:3000/api/settings.cleanStoppedContainers", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanDockerBuilder ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanDockerBuilder" ``` ```js fetch("http://localhost:3000/api/settings.cleanDockerBuilder", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanDockerPrune ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanDockerPrune" ``` ```js fetch("http://localhost:3000/api/settings.cleanDockerPrune", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanAll ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanAll" ``` ```js fetch("http://localhost:3000/api/settings.cleanAll", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanMonitoring ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanMonitoring" ``` ```js fetch("http://localhost:3000/api/settings.cleanMonitoring", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-saveSSHPrivateKey ### Authorization "} required={true}> In: `header` ### Request Body | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.saveSSHPrivateKey" \ -d '{ "sshPrivateKey": "string" }' ``` ```js fetch("http://localhost:3000/api/settings.saveSSHPrivateKey", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-assignDomainServer ### Authorization "} required={true}> In: `header` ### Request Body Default: `"none"` Value in: `"letsencrypt" | "none"` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.assignDomainServer" \ -d '{ "letsEncryptEmail": "string", "host": "string", "certificateType": "letsencrypt" }' ``` ```js fetch("http://localhost:3000/api/settings.assignDomainServer", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-cleanSSHPrivateKey ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.cleanSSHPrivateKey" ``` ```js fetch("http://localhost:3000/api/settings.cleanSSHPrivateKey", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-updateDockerCleanup ### Authorization "} required={true}> In: `header` ### Request Body | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.updateDockerCleanup" \ -d '{ "enableDockerCleanup": true }' ``` ```js fetch("http://localhost:3000/api/settings.updateDockerCleanup", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-readTraefikConfig ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.readTraefikConfig" ``` ```js fetch("http://localhost:3000/api/settings.readTraefikConfig", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-updateTraefikConfig ### Authorization "} required={true}> In: `header` ### Request Body Minimum length: `1` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.updateTraefikConfig" \ -d '{ "traefikConfig": "string" }' ``` ```js fetch("http://localhost:3000/api/settings.updateTraefikConfig", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-readWebServerTraefikConfig ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.readWebServerTraefikConfig" ``` ```js fetch("http://localhost:3000/api/settings.readWebServerTraefikConfig", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-updateWebServerTraefikConfig ### Authorization "} required={true}> In: `header` ### Request Body Minimum length: `1` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.updateWebServerTraefikConfig" \ -d '{ "traefikConfig": "string" }' ``` ```js fetch("http://localhost:3000/api/settings.updateWebServerTraefikConfig", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-readMiddlewareTraefikConfig ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.readMiddlewareTraefikConfig" ``` ```js fetch("http://localhost:3000/api/settings.readMiddlewareTraefikConfig", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-updateMiddlewareTraefikConfig ### Authorization "} required={true}> In: `header` ### Request Body Minimum length: `1` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.updateMiddlewareTraefikConfig" \ -d '{ "traefikConfig": "string" }' ``` ```js fetch("http://localhost:3000/api/settings.updateMiddlewareTraefikConfig", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-checkAndUpdateImage ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.checkAndUpdateImage" ``` ```js fetch("http://localhost:3000/api/settings.checkAndUpdateImage", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-updateServer ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.updateServer" ``` ```js fetch("http://localhost:3000/api/settings.updateServer", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-getDokployVersion ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.getDokployVersion" ``` ```js fetch("http://localhost:3000/api/settings.getDokployVersion", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-readDirectories ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.readDirectories" ``` ```js fetch("http://localhost:3000/api/settings.readDirectories", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-updateTraefikFile ### Authorization "} required={true}> In: `header` ### Request Body Minimum length: `1` Minimum length: `1` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.updateTraefikFile" \ -d '{ "path": "string", "traefikConfig": "string" }' ``` ```js fetch("http://localhost:3000/api/settings.updateTraefikFile", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-readTraefikFile ### Authorization "} required={true}> In: `header` ### Query Parameters Minimum length: `1` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.readTraefikFile?path=string" ``` ```js fetch("http://localhost:3000/api/settings.readTraefikFile?path=string", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-getIp ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.getIp" ``` ```js fetch("http://localhost:3000/api/settings.getIp", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-getOpenApiDocument ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.getOpenApiDocument" ``` ```js fetch("http://localhost:3000/api/settings.getOpenApiDocument", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-readTraefikEnv ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.readTraefikEnv" ``` ```js fetch("http://localhost:3000/api/settings.readTraefikEnv", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-writeTraefikEnv ### Authorization "} required={true}> In: `header` ### Request Body | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X POST "http://localhost:3000/api/settings.writeTraefikEnv" \ -d '{ "env": "string" }' ``` ```js fetch("http://localhost:3000/api/settings.writeTraefikEnv", { method: "POST" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ``` ## settings-haveTraefikDashboardPortEnabled ### Authorization "} required={true}> In: `header` | Status code | Description | | ----------- | ----------- | | `200` | Successful response | | `default` | Error response | ```bash curl -X GET "http://localhost:3000/api/settings.haveTraefikDashboardPortEnabled" ``` ```js fetch("http://localhost:3000/api/settings.haveTraefikDashboardPortEnabled", { method: "GET" }); ``` ```json { "message": "string", "code": "string", "issues": [ { "message": "string" } ] } ``` ```ts export interface Response { message: string; code: string; issues?: { message: string; }[]; } ```