Manage automations

​

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)

​

Enable an automation

1. Open the Automations page in your dashboard.
2. Click the toggle beside an automation to enable it.
   
   If the automation can run with default settings, it activates immediately. Otherwise, the automation’s configure page opens so you can fill in any required configurations.
3. If the configure page opens, fill in the required fields and click Save.

To change settings for an active automation, click the settings button on its card to open its configure page. Use the toggle in the page header to enable or disable the automation, and click Save to apply your changes.

​

Configurations

​

Trigger

Each automation has a default trigger that controls when it runs. To change the trigger, select a different trigger type on the automation’s configure page.

• Content update: Runs whenever you push content to your project repository, including pull request merges and direct pushes.
• Code change: Runs when a pull request merges in a connected source code repository. You must specify at least one source repository.
• Custom schedule: Runs on a recurring schedule you define. Pick a preset (Daily, Every Monday, Every Friday, or Twice weekly) and a start hour, or select Custom cron and enter a standard 5-field cron expression (minute hour day month weekday). Automations queue within 10 minutes of the scheduled time.
• Integration: Runs when a selected event occurs in a connected shared integration or when a new message posts to a selected Slack channel. Available for custom automations. Select the integration and event, then complete any additional event fields that appear. For Slack triggers, pick one or more channels that you have added the Mintlify Slack app to.

​

Update mode

Each automation has a default mode for how it makes updates: either directly merging changes into your content repository, or opening a pull request for review. Select the mode in the After automation runs section of the automation’s configure page. Select Update and merge changes to merge changes automatically. Select Modify and wait for review to require a review before changes go live.

​

Context repositories

For custom automations and some predefined automations, you can add context repositories—additional source code repositories the agent reads when the automation runs. This is useful when your automation prompt references code, APIs, or other content that lives outside your project repository. You can add up to 10 context repositories per automation. For each GitHub repository, install the Mintlify GitHub App. Add repositories on the GitHub App settings page.

​

Integrations

For custom automations and supported predefined automations, enable connected integrations. The agent pulls context from shared tools like Notion, Jira, or Linear when the automation runs. To enable integrations for an automation, open its configure page and select the integrations you want to use in Tools. If you select Integration as the trigger for a custom automation, the triggering integration is always a tool for that automation. See Integrations for connection scopes, supported events, and permissions.

​

Slack notifications

Send Slack messages to one or more channels when automations run. To enable Slack notifications:

1. Install the Mintlify Slack app in your workspace.
2. Click Configure Slack on the Automations page of your dashboard.
3. Select one or more channels to send notifications to.
4. Click Save changes.

Once enabled, Mintlify posts to the selected channels when:

• An automation opens a pull request for review.
• An automation pull request has been waiting for review for three days.
• An automation merges a pull request, or fails to complete.

​

Instructions

Add optional instructions that append to the automation’s base prompt on every run. Use these to adjust the style, tone, or other project-specific behaviors without changing the core automation logic.

​

Target languages

When you enable the Translate content automation, select one or more languages to keep in sync with your source content.

• Mintlify reads the languages defined in your docs.json to identify your default language and preselects any already configured target languages.
• You must select at least one target language to save the automation.
• You cannot select the source language as a target.

You can add target languages at any time by opening the automation’s configure page and editing the Translate to field.

​

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.

​

Disable an automation

1. Open the Automations page in your dashboard.
2. Click the toggle beside an automation to disable it.

When you re-enable a scheduled automation or change its schedule, Mintlify recalculates the next run time from the current time. Disabled automations do not retain a pending run time.

​

Delete an automation

1. Open the Automations page in your dashboard.
2. Click the settings button on the custom automation’s card to open its configure page.
3. Click Delete automation at the bottom of the page and confirm.

To delete any automation from the terminal, use mint automations. Deletion is permanent and cannot be undone.

​

Run an automation manually

You can trigger an automation on demand without waiting for its next scheduled or event-based run.

1. Open the Automations page in your dashboard.
2. Click the settings button on the automation’s card to open its configure page.
3. Click the run button (Test run or Run now, depending on the automation).
4. Select the run scope.
   • Since a date: Reviews changes from the selected date through the current time. The date defaults to the automation’s last run, or seven days ago if it has never run.
   • Everything: Reviews the entire site or repository history. This scope usually takes longer and uses significantly more credits than a targeted run.
   • Specific pull request: Limits the run to one pull request in a selected repository.
5. Click Run now.

Manual runs save the automation’s current configuration and activate the automation before starting. They count toward your credit usage and appear in the run history alongside automatically triggered runs. You can manually run automations with schedule, content update, or code change triggers. Integration-triggered automations run only when their configured event occurs, so their run button is unavailable. The Translate content automation can always run manually.

​

Trigger a scheduled automation via API

For automations with a Custom schedule trigger, you can start a run from your own tooling instead of waiting for the next scheduled time. Use the Trigger automation endpoint to fire a run from a CI/CD pipeline, release script, or any service that can make an authenticated HTTP request. API-triggered runs behave exactly like scheduled runs: they pick up everything that has changed since the last completed run, count toward credit usage, and appear in the run history.

​

View run history

The Runs tab on the automations page displays a list of all runs for all automations. A run is one execution of an automation. A run can create a new pull request, update an existing pull request, fail to run, or find nothing to change.

1. Open the Automations page in your dashboard.
2. Use the dropdown menus to filter by specific automations or status.

Each result shows one of the following statuses:

• Review needed: The agent finished the run, but someone on your team must review and merge the changes.
• Running: The agent is actively working on the automation job.
• Accepted: The agent finished the run and the changes merged into your repository.
• Closed: The agent finished the run, but someone rejected the changes.
• Failed: The agent could not complete the run.
• No action needed: The agent finished the run but did not find anything to update.
• Modified PR: The result appended changes to a pull request opened by an earlier run.

You can act on results directly from the list. For runs awaiting review, click Accept to merge the changes or Preview to view the changes in the editor. For failed results, click Re-trigger to start the run again. To see a run’s prompt, the files it read or changed, and any pull requests, click the run’s actions menu then click View run details.

​

Continue a run in the editor

After an automation completes and creates changes on a branch, you can open those changes directly in the editor to review, refine, or publish them.

1. Open the Automations page in your dashboard.
2. On the Runs tab, click Preview on the run you want to continue working on in the editor.

The editor opens to the automation’s branch with the agent panel already open. The agent panel shows each page the automation changed. Click any page to view changes made by the automation. The editor agent has full context on what the automation did, including the automation’s prompt, a summary of the changes, and which pages the automation modified. Ask the agent to refine or extend the work without re-explaining the background.