Skip to main content
Automations run the agent automatically on a schedule or in response to changes in a repository. Each automation defines a prompt for the agent and a trigger for when to run it. Automations support both GitHub and GitLab repositories. When an automation runs, the agent reads your project content and any connected repositories, then follows the prompt to make updates.
Use automations that run on a schedule for recurring tasks, like publishing changelogs or auditing SEO metadata.Use automations that trigger on content or code changes for reactive maintenance, like translations or updating content when source code changes.

​
Trigger types

Automations support three trigger types.
  • Content update: Run when content changes push to your Mintlify project repository, including pull request merges and direct pushes.
  • Code change: Run when a pull request merges in a connected source code repository.
  • Custom schedule: Run on a recurring schedule. Automations queue within 10 minutes of the scheduled time.
Each automation has exactly one trigger. You cannot combine trigger types in a single automation.

​
Usage limits

Automation runs count toward your credit usage. See your credit usage, set overages, and manage your credit package on the Usage page of your dashboard. Each automation can run up to 500 times per day. Runs that fail do not count toward this limit.

​
Next steps

Predefined automations

Reference for all predefined automations: triggers, update modes, and required configuration.

Manage automations

Turn on predefined automations and configure triggers, update mode, and context.

Create a custom automation

Build an automation with your own trigger, instructions, and context repositories.

Learn best practices

Choose the right trigger, write effective instructions, and review results.

Related topics

Use casesGuidesWhat is Mintlify?