Mintlify Workflows is a feature of the 📝Mintlify documentation platform that runs scheduled and event-triggered 📝Artificial Intelligence (AI) agents to draft, update, and maintain a project's docs automatically.
Workflows are defined as Markdown files with YAML frontmatter inside a repository's .mintlify/workflows/ directory. Each file declares a trigger, a natural-language prompt, and optional context repositories to clone. Two trigger types are supported: cron schedules for recurring work, and repository pushes for reactive work. When a workflow fires, a Mintlify agent executes the prompt and either opens a pull request for review or pushes directly to the deployment branch, subject to a cap of 50 successful runs per day per workflow.
Cron-triggered workflows handle recurring documentation hygiene such as changelog drafting, broken-link sweeps, and style passes. Push-triggered workflows handle maintenance that should react to code changes — updating API references and flagging documentation gaps when product code ships. As of May 2026, the feature was available as a free beta. Workflows extend Mintlify's broader thesis that documentation is living infrastructure best kept current by agents rather than periodic manual review.
The workflow primitive is the interesting move — declarative agent automation living in the same repo as the content it maintains. It maps cleanly onto the same pattern MythOS uses for agent-facing instructions, and the suggest-changes-via-PR pattern is the right loop for keeping a human in the accept/reject seat without bottlenecking velocity.