Skip to main content
GET
/
runs
/
{id}
/
settings
Retrieve Run Settings
curl --request GET \
  --url https://api.example.com/runs/{id}/settings \
  --header 'Authorization: Bearer <token>'
{
  "version": 1,
  "graph": "fix_build.fabro",
  "goal": "Diagnose and fix CI build failures",
  "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": {},
  "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
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Unique run identifier (ULID).

Response

Run settings

Structured run settings mirroring FabroSettings.

version
integer
required

Settings schema version.

Example:

1

graph
string
required

Graphviz graph filename.

Example:

"fix_build.fabro"

goal
string

Goal description for the run.

Example:

"Diagnose and fix CI build failures"

work_dir
string

Working directory for the run.

llm
object

LLM provider and model settings.

setup
object

Setup commands run before the workflow.

sandbox
object

Sandbox execution environment settings.

vars
object

Variable map for template expansion.

hooks
object[]