Branch

Properties

Property	Description	Values	Example
`name` string	name of the app branch	✅ Required	-
`connected_repo` ConnectedRepoConfig	connected GitHub repo the branch tracks	Optional	-
`public_repo` PublicRepoConfig	public git repo the branch tracks	Optional	-
`install_groups` array	ordered deployment groups for this branch	Optional	-
`preview` AppBranchPreviewConfig	default preview run settings for this branch	Optional	-
`post_deploy_runbooks` array	names of runbooks to run on each install, in order, after its deploy succeeds; resolved to IDs at sync time	Optional	-
`ignore_changes_regex` string	RE2 regex matched against every changed file path; a run whose entire changed file set matches is not attempted	Optional	-
`send_statuses_on_ignore` boolean	whether to send a successful commit status when a run is ignored by ignore_changes_regex	Optional	-

`connected_repo`

Property	Description	Values	Example
`repo` string	repository identifier Identifier of the connected repository configured in the Nuon platform	✅ Required	`"my-repo"`, `"production-infrastructure"`
`directory` string	directory path Path within the repository to the configuration files	✅ Required	`"terraform"`, `"infra/terraform"`
`branch` string	Git branch Git branch to checkout and use for deployments	✅ Required	`"main"`, `"develop"`, `"production"`

`public_repo`

Property	Description	Values	Example
`repo` string	repository URL HTTPS URL to the public Git repository	✅ Required	`"https://github.com/user/repo.git"`, `"https://github.com/user/terraform-modules.git"`
`directory` string	directory path Path within the repository to the configuration files	✅ Required	`"terraform"`, `"infra/terraform"`
`branch` string	Git branch Git branch to checkout and use for deployments	✅ Required	`"main"`, `"develop"`, `"production"`

`install_groups`

Property	Description	Values	Example
`name` string	name of the install group	✅ Required	-
`order` integer	deployment order (lower runs first)	Optional	-
`install_ids` array	static list of install IDs	Optional	-
`install_names` array	static list of install names, resolved to IDs at sync time	Optional	-
`label_selector` object	label key-value pairs to dynamically match installs	Optional	-
`auto_approve_on_policies_passing` boolean	Auto-approve this group’s plan when all policy checks pass. Defaults to false	Optional	-

`preview`

Property	Description	Values	Example
`mode` string	preview run mode: plan-only, apply, or build-only	Optional	-
`install_id` string	default install ID for preview runs	Optional	-
`install_name` string	default install name for preview runs, resolved to an ID at sync time	Optional	-
`label_selector` object	label key-value pairs to select the default preview install	Optional	-
`set_statuses` boolean	whether to set GitHub commit statuses for preview runs	Optional	-
`comment` boolean	whether to comment on the pull request with preview results	Optional	-