Skip to main content
When the Mintlify agent or an automation opens a pull request, it targets the deploy branch configured for your project (usually main). This is the branch Mintlify builds your live site from, so PRs land there by default and publish on merge. If you want changes to go somewhere else, the control depends on how the run was started.

Agent runs in Slack, the editor, or the dashboard

For a single agent run, name the branch you want in the prompt. The agent creates the pull request against the branch you name, or pushes commits directly to it when the branch already exists. For example:
  • “Open the PR against the staging branch.”
  • “Push these commits to docs-refresh.”
See Send messages to the agent for the Slack flow. See Choose how the agent publishes changes for the workspace-level review process setting that decides between opening a PR and pushing directly to your deploy branch.

Automations

Automations always open their pull requests against the deploy branch. There is no per-automation setting to target a different base branch. If you need automation output to land on a non-production branch, point the project itself at that branch in Git Settings, or use a separate project for that branch and run the automation there. To stop automation PRs from merging without review, turn off Update and merge changes on the automation’s configure page. See Update mode.