Settings

Factory settings are one revisioned document per tenant. Change them on the console’s Factory settings page or with PUT /v1/factory/settings. Keys stored on sandbox belong to the Pix Sandbox and are edited here for convenience. A key marked locked cannot be changed.

Sections: agents · approve · audit · autonomy · belai · budget · crews · defaults · delivery · factory · other · github · hosts · jail · kanban · notify · persistence · pix · providers · schedules · scope · security · signing · systemone · tea · vault

agents

Key	Type and values	Default	Stored	Explained in
agents.finalize_at	num 0 to 0.95: share of any per-card limit at which the worker is told to wrap up (commit, record findings, publish a draft pull request); a value under 0.5 is raised to 0.5 (0 keeps the agent’s own, 0.85 for the built-ins)	0	factory	Per-agent and per-card limits
agents.max_attempts	int 0 to 10: failed attempts at one stage before Belai blocks the card (0 keeps the agent’s own). Not autonomy.max_attempts, which retries a workflow step	0	factory	Per-agent and per-card limits
agents.max_continuations	int 0 to 50: times a card may go back to be resumed after its budget ran out with progress made, before it is blocked for a person (0 keeps the agent’s own, 5 by default)	0	factory	Per-agent and per-card limits
agents.max_cost_usd_per_item	num 0 to 10000: estimated cost in US dollars at which a worker’s claim on one card ends (0 keeps each agent’s own; the built-in agents allow $8 to $25)	0	factory	Per-agent and per-card limits
agents.max_iterations	int 0 to 400: tool rounds per pass (0 keeps the agent’s own)	0	factory	Per-agent and per-card limits
agents.max_passes_per_item	int 0 to 1000: goal passes per card, a safety rail beside the cost limit (0 keeps the agent’s own)	0	factory	Per-agent and per-card limits
agents.max_wall_minutes	int 0 to 10080: minutes per card, a safety rail (0 keeps the agent’s own)	0	factory	Per-agent and per-card limits

approve

Key	Type and values	Default	Stored	Explained in
approve.sensitive_paths	list. list of path globs (feGlobMatch dialect) that stop an approval, besides the built-in list	[]	factory

audit

Key	Type and values	Default	Stored	Explained in
audit.calls	bool. bool: log every model call with its input hash	true	factory	The audit ledger
audit.sign	bool. bool: sign the decision ledger	true	factory	The audit ledger
audit.weekly_report	bool	true	factory	The audit ledger

autonomy

Key	Type and values	Default	Stored	Explained in
autonomy.claim_ttl_minutes	int 1 to 1440. int 1 to 1440: minutes a started crew or worker dispatch may go without a session before the attempt fails card_unclaimed and retries	60	factory	Autonomy levels
autonomy.concurrency	int 1 to 64	4	factory	Autonomy levels
autonomy.default	enum: observe, suggest, draft_pr, auto_merge_low_risk	draft_pr	factory	Autonomy levels
autonomy.max	enum: observe, suggest, draft_pr, auto_merge_low_risk	draft_pr	factory	Autonomy levels
autonomy.max_attempts	int 1 to 10	3	factory	Autonomy levels
autonomy.no_host_ttl_hours	int 1 to 168. int 1 to 168: hours a crew step may wait for a machine before the run ends no_host_timeout	6	factory	Autonomy levels
autonomy.parked_concurrency	int 1 to 1000. int 1 to 1000: runs of the tenant that may wait for a machine at once; they do not count against autonomy.concurrency	50	factory	Autonomy levels
autonomy.plan_approval	bool. bool (plan approval for belai:feature)	true	factory	Autonomy levels

belai

Key	Type and values	Default	Stored	Explained in
belai.a2a.show	bool. bool: transcripts show A2A rows (broadcasts, messages, replies, acks) by default; a viewer can override it locally	true	factory
belai.ask_permission	bool: whether the workers and crews a workflow or schedule starts stop at permission asks (sent as the dispatch’s ask; docs/factory-engine.md, “Stay and replicas”)	false	factory
belai.auto_commit_per_task	bool	true	factory
belai.guardrails	enum: on, strict, off	on	factory
belai.mode	enum: goal, agent, plan, auto	goal	factory
belai.show_internal_work	enum: decisions, security, all, hidden	decisions	factory
belai.tests.on_fail	enum: fix, diagnose, off	fix	factory
belai.tests.post_end	enum: goal, goal_plan, session, off	goal	factory

budget

Key	Type and values	Default	Stored	Explained in
budget.alerts	list. list of int 1 to 100, ascending	[50, 80, 100]	factory	Budgets
budget.factory_share	pct. pct of the Pix allowance	75	factory	Budgets
budget.month	int 0 to 1e15. int tokens, all providers	30000000	factory	Budgets
budget.on_exceed	enum: pause_run, downgrade_to_fast, switch_to_pix_allocation, escalate_human, hard_stop	switch_to_pix_allocation	factory	Budgets

crews

Key	Type and values	Default	Stored	Explained in
crews.lease	enum: 15m, 30m, 2h	30m	factory

defaults

Key	Type and values	Default	Stored	Explained in
defaults.approve-ready.enabled	bool	true	factory
defaults.ci-fix.enabled	bool	true	factory
defaults.conflict-fix.enabled	bool	true	factory
defaults.enabled	bool. bool: master switch	true	factory
defaults.issue-to-pr.enabled	bool	true	factory
defaults.lint-sweep.enabled	bool	true	factory
defaults.pr-review.enabled	bool	true	factory
defaults.test-sweep.enabled	bool	true	factory

delivery

Key	Type and values	Default	Stored	Explained in
delivery.companyDomain	str. str: an email domain such as acme.example, or empty		factory	Delivery
delivery.compare	bool. bool: the hand-worked comparison, which adds the refinement and hand-off overhead	true	factory	Delivery
delivery.decisions	bool. bool: price the decisions System One scored	true	factory	Delivery
delivery.enabled	bool. bool: master switch. Off, every /delivery read answers {"enabled":false} and nothing is computed	true	factory	Delivery
delivery.hoursPerMonth	num 1 to 400: productive hours per person-month	150	factory	Delivery
delivery.idleGapMin	int 1 to 120. int 1 to 120: minutes without an action that end a sitting	5	factory	Delivery
delivery.kinds.goal.enabled	bool	true	factory	Delivery
delivery.kinds.goal.minutes	num 0 to 480	3	factory	Delivery
delivery.kinds.merge.enabled	bool	true	factory	Delivery
delivery.kinds.merge.minutes	num 0 to 480	8	factory	Delivery
delivery.kinds.mode.enabled	bool	true	factory	Delivery
delivery.kinds.mode.minutes	num 0 to 480	0.5	factory	Delivery
delivery.kinds.other.enabled	bool	true	factory	Delivery
delivery.kinds.other.minutes	num 0 to 480	2	factory	Delivery
delivery.kinds.plan.enabled	bool	true	factory	Delivery
delivery.kinds.plan.minutes	num 0 to 480	4	factory	Delivery
delivery.kinds.toolcall.enabled	bool	false	factory	Delivery
delivery.kinds.toolcall.minutes	num 0 to 480	0	factory	Delivery
delivery.kinds.triage.enabled	bool	true	factory	Delivery
delivery.kinds.triage.minutes	num 0 to 480	6	factory	Delivery
delivery.manualCardDays	num 0 to 365: days a team takes per card	5	factory	Delivery
delivery.manualCycleDays	num 0 to 365: days a team takes per pull request	4.5	factory	Delivery
delivery.manualDecisionWait	num 0 to 720: hours a team waits to decide, compared with the measured time	6	factory	Delivery
delivery.manualIssueDays	num 0 to 365: days a team takes per issue	3	factory	Delivery
delivery.multiplier	num 0.5 to 10: multiplier for agent work no role covers	2.4	factory	Delivery
delivery.overheadPct	pct. pct: refinement and hand-off overhead as a share of build and decision hours	20	factory	Delivery
delivery.overheadRate	num 0 to 10000: USD per hour for the overhead	105	factory	Delivery
delivery.people	bool. bool: the People and Contributors pages	true	factory	Delivery
delivery.peopleRate	num 0 to 10000: USD per hour for the hours people spent in the factory (the cost side)	110	factory	Delivery
delivery.rate	num 0 to 10000: USD per hour for agent work no role covers	95	factory	Delivery
delivery.reviewMinPer100	num 0 to 60: minutes of reading per 100 changed lines of a review	4	factory	Delivery
delivery.roles.devops.enabled	bool	true	factory	Delivery
delivery.roles.devops.mult	num 0.5 to 10	2.0	factory	Delivery
delivery.roles.devops.rate	num 0 to 10000	90	factory	Delivery
delivery.roles.planner.enabled	bool	true	factory	Delivery
delivery.roles.planner.mult	num 0.5 to 10	1.6	factory	Delivery
delivery.roles.planner.rate	num 0 to 10000	120	factory	Delivery
delivery.roles.qa.enabled	bool	true	factory	Delivery
delivery.roles.qa.mult	num 0.5 to 10	2.2	factory	Delivery
delivery.roles.qa.rate	num 0 to 10000	70	factory	Delivery
delivery.roles.reviewer.enabled	bool	true	factory	Delivery
delivery.roles.reviewer.mult	num 0.5 to 10	1.5	factory	Delivery
delivery.roles.reviewer.rate	num 0 to 10000	95	factory	Delivery
delivery.roles.security.enabled	bool	true	factory	Delivery
delivery.roles.security.mult	num 0.5 to 10	2.0	factory	Delivery
delivery.roles.security.rate	num 0 to 10000	110	factory	Delivery
delivery.roles.sse.enabled	bool	true	factory	Delivery
delivery.roles.sse.mult	num 0.5 to 10	2.4	factory	Delivery
delivery.roles.sse.rate	num 0 to 10000	95	factory	Delivery
delivery.roles.writer.enabled	bool	true	factory	Delivery
delivery.roles.writer.mult	num 0.5 to 10	1.8	factory	Delivery
delivery.roles.writer.rate	num 0 to 10000	60	factory	Delivery
delivery.sources.admin	bool	true	factory	Delivery
delivery.sources.chat	bool	true	factory	Delivery
delivery.sources.checkpoint	bool	true	factory	Delivery
delivery.sources.comment	bool	true	factory	Delivery
delivery.sources.commit	bool	true	factory	Delivery
delivery.sources.notification	bool	true	factory	Delivery
delivery.sources.pixcall	bool	true	factory	Delivery
delivery.sources.review	bool	true	factory	Delivery
delivery.value	bool. bool: price agent work by role	true	factory	Delivery

factory

Key	Type and values	Default	Stored	Explained in
factory.fanoutCap	int 1 to 50. int 1 to 50: runs one delivery or sighting may start; triggers past it, by priority, are skipped as fanout_cap	feDefaultFanoutCap	factory

other

Key	Type and values	Default	Stored	Explained in
firewall_enabled	bool	true	factory, locked	Package and AI firewalls on factory work

github

Key	Type and values	Default	Stored	Explained in
github.branch_prefix	str. str, 1 to 40 chars, [A-Za-z0-9/_.-]	belai/K-	factory	GitHub quota and the data plane
github.check_runs	bool. bool: publish gate results as check runs (needs checks: write)	false	factory	GitHub quota and the data plane
github.etag	bool. bool: send If-None-Match on every live read	true	factory	GitHub quota and the data plane
github.poll.fallback	enum: conditional_poll_10m, none	conditional_poll_10m	factory	GitHub quota and the data plane
github.polling.forbidden	bool. bool, locked true	true	factory, locked	GitHub quota and the data plane
github.pr_state	enum: draft, ready	draft	factory	GitHub quota and the data plane
github.protected	bool. bool: never push to protected branches	true	factory	GitHub quota and the data plane
github.quota.factory_share	pct	10	factory	GitHub quota and the data plane
github.quota.on_exhausted	enum: pause_live_reads, defer_to_next_window, escalate	pause_live_reads	factory	GitHub quota and the data plane
github.quota.proactive_writes_per_hour	int 0 to 5000. int 0 to 5000: most calls an installation makes in a clock hour for default workflows (13.4)	60	factory	GitHub quota and the data plane
github.quota.reserve	pct	20	factory	GitHub quota and the data plane
github.read.default	enum: posture_mirror, s3_raw, live_api	posture_mirror	factory	GitHub quota and the data plane
github.stale.alerts	duration. dur	1h	factory	GitHub quota and the data plane
github.stale.checks	duration. dur	2m	factory	GitHub quota and the data plane
github.stale.pulls	duration. dur	5m	factory	GitHub quota and the data plane
github.stale.repo	duration. dur	6h	factory	GitHub quota and the data plane

hosts

Key	Type and values	Default	Stored	Explained in
hosts.runOn	str. string auto, pix_sandbox, self_hosted, host:<uuid> or label:<name>, the crew node’s runOn grammar (factoryRunOnValid): where a crew node, a default or a scan that names no runOn runs, and the preference that orders the hosts a node’s own runOn admits (12.5)	auto	factory	Hosts and placement
hosts.runOnFallback	enum: none, auto	auto	factory	Hosts and placement

jail

Key	Type and values	Default	Stored	Explained in
jail.enforcementMode	enum: enforce, warn	enforce	jail	Trust and SLSA

kanban

Key	Type and values	Default	Stored	Explained in
kanban.conflict_comment	bool	true	factory
kanban.mode	enum: all, skip_review, off	all	factory
kanban.opt_out_label	str	no-github	factory

notify

Key	Type and values	Default	Stored	Explained in
notify.connector	enum: slack, teams, discord, google_chat, webhook, jira	slack	factory	The messaging centre: connections, routes and templates
notify.events	enum: escalations_holds_budget, everything, escalations_only	escalations_holds_budget	factory	The messaging centre: connections, routes and templates

persistence

Key	Type and values	Default	Stored	Explained in
persistence.export	enum: daily_jsonl_s3, manual	manual	factory
persistence.postgres	enum: on, off	on	factory
persistence.retention	enum: 400d, 90d, 30d, forever	400d	factory

pix

Key	Type and values	Default	Stored	Explained in
pix.classifier	enum: clef, jev, tev1	clef	sandbox	Pix Sandboxes
pix.egressMode	enum. enum deny_except_allow, allow_all_logged	deny_except_allow	sandbox	Pix Sandboxes
pix.extensionMode	enum: packs_only, any_indexed	packs_only	sandbox	Pix Sandboxes
pix.jevDailyCap	int 0 to 100_000_000. int, calls per day, shared with the sandbox	2000	sandbox	Pix Sandboxes
pix.maintenance	list. list of {days:["sun"],start:"02:00",end:"04:00",tz:"Australia/Melbourne"}, same value as PUT /v1/belai/sandboxes/{id}/maintenance-window	[]	sandbox	Holds, maintenance windows and blackouts
pix.reservePercent	pct. pct (same value as budgets reserveInteractivePct)	20	sandbox	Pix Sandboxes
pix.size	enum. enum small, medium, large	medium	sandbox	Pix Sandboxes
pix.versionPolicy	enum. enum safest, stable, latest, rolling, pinned (the first four are the Safe Harbour picks, see pix-sandbox-safe-harbour.md)	safest	sandbox	Pix Sandboxes

providers

Key	Type and values	Default	Stored	Explained in
providers.ai_gateway	bool. bool: route calls through Cloudflare AI Gateway	false	factory	Model routing and the Pix allowance
providers.code	str. pix-smart, pix-fast or vault:<entryId>	pix-smart	factory	Model routing and the Pix allowance

schedules

Key	Type and values	Default	Stored	Explained in
schedules.blackout	list. list of {from:{day,time},to:{day,time},label}; day is mon to sun, time HH:MM	[]	factory	Holds, maintenance windows and blackouts
schedules.missed	enum: run_once, skip, run_all	run_once	factory	Holds, maintenance windows and blackouts
schedules.tz	tz. IANA zone	UTC	factory	Holds, maintenance windows and blackouts

scope

Key	Type and values	Default	Stored	Explained in
scope.archived	bool	false	factory	Managed orgs and repositories
scope.dependencies	bool	false	factory	Managed orgs and repositories
scope.interest	enum: any_signal, scanned_or_pix, watched_only	any_signal	factory	Managed orgs and repositories
scope.orgs	list. "all_active" or list of installation logins; same write as PUT /orgs/{id}	[]	factory	Managed orgs and repositories
scope.sync	enum: 6h, 1h, webhook_only	6h	factory	Managed orgs and repositories

security

Key	Type and values	Default	Stored	Explained in
security.evidence	enum: cdx_slsa, sbom_only	cdx_slsa	factory	Trust and SLSA
security.scanners	enum: minimum, all, custom	minimum	factory	Trust and SLSA
security.scanners.custom	list	[]	factory	Trust and SLSA
security.slsa_min	enum: L1, L2, L3	L3	factory	Trust and SLSA

signing

Key	Type and values	Default	Stored	Explained in
signing.auto_add	bool. bool: add a new key’s public key to the person’s GitHub account	true	factory	Commit signing
signing.email	enum: primary, noreply, ask	primary	factory	Commit signing
signing.mode	enum: required, preferred, off	preferred	factory	Commit signing
signing.on_missing	enum: readd, ask	readd	factory	Commit signing
signing.retire_days	enum: 30, 7, 0, -1	30	factory	Commit signing
signing.rotate_days	enum: 365, 180, 90, 0	365	factory	Commit signing

systemone

Key	Type and values	Default	Stored	Explained in
systemone.below_threshold	enum: escalate_human, route_to_fallback_model, take_safest_outcome, end_run	escalate_human	factory	System One decisions
systemone.fallback	enum: jev, pix-fast, none	jev	factory	System One decisions
systemone.min_confidence	num 0 to 1	0.8	factory	System One decisions
systemone.min_confidence.adapter	str. str, read-only, identity the threshold was set for	clef-flash	factory	System One decisions
systemone.model	enum adapter name: clef-flash, clef, jev, tev1	clef-flash	factory	System One decisions
systemone.on_abstain	enum: escalate_human, retry_once_then_escalate, end_run	escalate_human	factory	System One decisions
systemone.override	bool. bool: a person may override any decision	true	factory	System One decisions
systemone.retention	enum: full_400d, hash_only, days_30	full_400d	factory	System One decisions

tea

Key	Type and values	Default	Stored	Explained in
tea.publish	enum: on_release_tag, on_merge_main, never	on_release_tag	factory	Trust and SLSA

vault

Key	Type and values	Default	Stored	Explained in
vault.grant	object. {"mode":"specific","entries":["ve_1"]} for the pix_sandbox surface; mode is specific, all or all_except	{"mode": "all"}	vault
vault.on_error	enum: pause_affected_workflows, fall_back_to_pix	pause_affected_workflows	factory