{
  "openapi": "3.0.3",
  "info": {
    "title": "Settings API",
    "version": "3.0",
    "contact": {
      "email": "admin@vsee.com"
    }
  },
  "servers": [
    {
      "url": "https://api.vseepreview.com/api_v3",
      "description": "Staging"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "samples-languages": [
      "curl",
      "python",
      "javascript",
      "java"
    ]
  },
  "paths": {
    "/settings": {
      "get": {
        "summary": "Get all settings",
        "description": "Retrieve all settings available for the account. Public access endpoint.",
        "tags": [
          "Settings"
        ],
        "parameters": [
          {
            "name": "X-ApiToken",
            "in": "header",
            "description": "API token",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "your_api_token"
          },
          {
            "name": "X-AccountCode",
            "in": "header",
            "description": "Account code",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "vclinic"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "visit": {
                          "type": "object",
                          "properties": {
                            "time": {
                              "type": "object",
                              "properties": {
                                "max_wait_time": {
                                  "type": "integer",
                                  "example": 86400
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "Success": {
                    "value": {
                      "data": {
                        "visit": {
                          "time": {
                            "max_wait_time": 86400
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "x-auth-type": "user-token"
      }
    },
    "/settings/{setting_key}": {
      "get": {
        "summary": "Get specific setting",
        "description": "Retrieve a specific settings value by key. Public access endpoint.\n\nFor nested settings, use the full path with forward slashes (e.g. `visit/time/max_wait_time`).",
        "tags": [
          "Settings"
        ],
        "parameters": [
          {
            "name": "X-ApiToken",
            "in": "header",
            "description": "API token",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "your_api_token"
          },
          {
            "name": "X-AccountCode",
            "in": "header",
            "description": "Account code",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "vclinic"
          },
          {
            "name": "setting_key",
            "in": "path",
            "description": "The settings key or path (e.g. `visit/time/max_wait_time`)",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "max_wait_time"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "integer"
                    }
                  }
                },
                "examples": {
                  "Integer Value": {
                    "value": {
                      "data": 86400
                    }
                  }
                }
              }
            }
          }
        },
        "x-auth-type": "user-token"
      }
    }
  }
}