Skip to main content
GET
/
settings
Retrieve Server Settings
curl --request GET \
  --url https://api.example.com/settings \
  --header 'Authorization: Bearer <token>'
{
  "storage_dir": "<string>",
  "max_concurrent_runs": 123,
  "web": {
    "url": "<string>",
    "auth": {
      "provider": "github",
      "allowed_usernames": [
        "<string>"
      ]
    }
  },
  "api": {
    "base_url": "<string>",
    "authentication_strategies": [
      "jwt"
    ],
    "tls": {
      "cert": "<string>",
      "key": "<string>",
      "ca": "<string>"
    }
  },
  "git": {
    "provider": "github",
    "app_id": "<string>",
    "client_id": "<string>",
    "slug": "<string>",
    "author": {
      "name": "<string>",
      "email": "<string>"
    },
    "webhooks": {
      "strategy": "tailscale_funnel"
    }
  },
  "features": {
    "session_sandboxes": true,
    "retros": true
  },
  "log": {
    "level": "<string>"
  },
  "work_dir": "<string>",
  "llm": {
    "model": "claude-sonnet",
    "provider": "anthropic",
    "fallbacks": {}
  },
  "setup": {
    "commands": [
      "<string>"
    ],
    "timeout_ms": 123
  },
  "sandbox": {
    "provider": "daytona",
    "preserve": true,
    "devcontainer": true,
    "daytona": {
      "auto_stop_interval": 123,
      "labels": {},
      "snapshot": {
        "name": "<string>",
        "cpu": 123,
        "memory": 123,
        "disk": 123,
        "dockerfile": "<string>"
      },
      "network": "block",
      "skip_clone": false
    },
    "exe": {
      "image": "<string>"
    },
    "ssh": {
      "destination": "<string>",
      "working_directory": "<string>",
      "config_file": "<string>"
    },
    "local": {
      "worktree_mode": "clean"
    },
    "env": {}
  },
  "vars": {},
  "checkpoint": {
    "exclude_globs": [
      "<string>"
    ]
  },
  "pull_request": {
    "enabled": true,
    "draft": true,
    "auto_merge": true,
    "merge_strategy": "squash"
  },
  "hooks": [
    {
      "event": "run_start",
      "name": "<string>",
      "command": "<string>",
      "type": "command",
      "url": "<string>",
      "headers": {},
      "allowed_env_vars": [
        "<string>"
      ],
      "tls": "verify",
      "prompt": "<string>",
      "model": "<string>",
      "max_tool_rounds": 123,
      "matcher": "<string>",
      "blocking": true,
      "timeout_ms": 123,
      "sandbox": true
    }
  ],
  "assets": {
    "include": [
      "<string>"
    ]
  },
  "mcp_servers": {},
  "github": {
    "permissions": {}
  }
}

Authorizations

Authorization
string
header
required

JWT bearer token issued by fabro-web. See the Authentication guide for details.

Response

200 - application/json

Server settings

Structured server settings mirroring FabroSettings.

storage_dir
string

Storage directory path.

max_concurrent_runs
integer

Maximum concurrent runs.

web
object

Web UI configuration.

api
object

API server configuration.

git
object

Git provider configuration.

features
object

Feature flags.

log
object

Logging configuration.

work_dir
string

Default working directory.

llm
object

LLM provider and model settings.

setup
object

Setup commands run before the workflow.

sandbox
object

Sandbox execution environment settings.

vars
object

Default variable map.

checkpoint
object

Checkpoint configuration for file exclusion.

pull_request
object

Pull request creation configuration.

hooks
object[]
assets
object

Asset collection configuration.

mcp_servers
object

Default MCP server configurations.

github
object

GitHub App token injection configuration.