Docs/Reference/Configuration

Configuration reference.

Every configuration key wrxstack reads, what it does, and its default. Keys are grouped by where they live: workspace settings and workflow files.

Workspace settings

Key	Type	Default	Description
`name`	string	-	Display name
`subdomain`	string	-	Used in `<subdomain>.wrxstack.com`
`region`	enum	`us`	`us`, `eu`, `uk`, `apac`, `me`
`retention.documents_days`	int	`0` (forever)	Hard-delete documents older than this
`retention.audit_days`	int	`2555` (7y)	Hard-delete audit log entries older than this
`retention.runs_days`	int	`365`	Hard-delete assistant runs older than this
`sso.enforcement`	enum	`off`	`off`, `soft`, `hard`
`sso.break_glass_user`	email	-	Single user that bypasses SSO during outages
`assistants.default_model`	string	`anthropic/claude-3-5-sonnet`	Default model for assistants without an explicit setting
`byom.endpoint`	url	-	Bring-your-own-model endpoint (Business+)
`byom.auth`	string	-	Header name or signing key id for BYOM

Workflow TOML keys

Key	Type	Required	Description
`workflow.name`	string	yes	Unique within workspace
`workflow.description`	string	no	Free text
`workflow.owner`	string	no	User, group, or role
`trigger.event`	string	yes	Event name from the catalog
`trigger.filter`	expr	no	Boolean expression on the event
`trigger.cron`	cron	conditional	Required when event is `schedule.*`
`scope.read`	string[]	yes	Read scopes
`scope.write`	string[]	yes	Write scopes
`steps[].name`	string	yes	Unique within workflow
`steps[].assistant`	string	conditional	One of `assistant` or `tool` required
`steps[].tool`	string	conditional	Tool id
`steps[].input`	object	no	JSON-shaped, may use `$trigger` / `$steps`
`steps[].when`	expr	no	Skip step unless true
`approvals.require`	string	no	Role or user that must approve
`approvals.above_arr_usd`	int	no	Threshold predicate
`approvals.escalation.after_minutes`	int	no	Escalate if unattended