Prerequisites
- A Mintlify project connected to a GitHub or GitLab repository
- For GitHub: the Mintlify GitHub App installed on every repository you plan to use in the automation
- For GitLab: a connected GitLab account (see GitLab setup below)
Create a custom automation
The agent runs in an isolated sandbox with restricted internet access. It cannot install additional packages or tools at runtime. Prompts that reference unavailable tools may produce unexpected results or fail.
- Open the Automations page in your dashboard.
- Click Create a custom automation.
- Configure the automation name, trigger, instructions, context repositories, integrations, and update mode.
- Click Create automation.
Write effective instructions
Effective automation instructions focus on a single task and define a clear, verifiable outcome. Automations have some variance because agents are nondeterministic, but well-formatted instructions produce more consistent results.- Describe the outcome. Tell the agent what a successful run should look like.
- Write a procedure. Give the agent a step-by-step guide to follow.
- Keep scope narrow. Split complex tasks across multiple automations rather than combining them into one prompt.
GitLab setup
To use GitLab repositories in an automation, connect each project through the GitLab OAuth settings page. Connect every repository the automation touches—your documentation repository and any trigger or context repositories. You must have at least the Maintainer role on each project.Automations require a paid GitLab tier. The agent uses short-lived project access tokens for repository access, which GitLab’s Free plan does not support.
Delete a custom automation
Deleting an automation is permanent and removes its configuration and run history.- Go to the Automations page in your dashboard.
- Click the settings button beside an automation.
- Click Delete.