Config Reference

Complete reference for Knowledge Base YAML fields, project settings, agent configuration options, and the storage policy that governs artifact retention and backup behavior.

Knowledge Base YAML fields

Application block

Field	Type	Required	Description
app.name	string	Yes	Project identifier slug (no spaces, lowercase)
app.base_url	URL	Yes	Base URL of the application under test
app.type	string	Yes	web, api, or web+api
app.auth.type	string	No	bearer, api_key, basic, oauth2_client

Domain block

Field	Type	Required	Description
domain	string	Yes	Domain identifier slug (used in scenario IDs and test file paths)
base_urls	string[]	No	List of URL paths this domain primarily covers. AppExplorer crawls these paths.

Scenario block

Field	Type	Required	Description
id	string	Yes	Unique scenario identifier. Convention: DOMAIN-NNN
title	string	Yes	Short description of what is being tested
steps	string[]	Yes	Ordered list of user/API actions
expected	string	Yes	Observable outcome that confirms the test passes
module	string	No	Override module: web_ui, api, api_contract, visual_regression, accessibility, security, performance
tags	string[]	No	Labels for test plan filtering
priority	string	No	high, medium, or low
endpoint	string	No	API endpoint path (API module hint)
method	string	No	HTTP method (API module hint): GET, POST, PUT, DELETE, PATCH
max_response_ms	integer	No	Performance threshold in milliseconds
auth_required	boolean	No	Whether this scenario requires an authenticated session (default: true)
viewport	string	No	Visual regression viewport: desktop, tablet, mobile

Project settings reference

All project settings are managed through the dashboard at Project → Settings. Key settings:

• Modules — enable/disable test modules
• Execution timeout — maximum run duration (default: 30 min)
• Parallel workers — concurrent test execution threads (default: 4, max: 16 on Pro)
• Flaky test quarantine — stability threshold below which tests are quarantined (default: 0.5)
• Contract strictness — whether non-breaking additions trigger contract test alerts
• Security scan target — which environment to run security tests against
• Artifact retention — local and backup storage behavior for generated evidence and run artifacts