Approve GitHub Preview Runs from Mintlify Requests
Preview requests should move forward quickly when the contributor and change are already trusted.
Trigger
Webhook received
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Action
Approve a workflow run for a fork pull request
Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration.
Why this helps
Manual approval gates interrupt focused work and make small documentation contributions wait.
- Shortens the wait for legitimate docs previews.
- Keeps approval criteria in one plain-language instruction.
- Leaves an auditable run report in the chosen channel.
Setup
Build it in a few focused steps.
- 1Connect Mintlify and GitHub to Notis once through the portal.
- 2Create the automation in the portal or ask Notis to create it conversationally.
- 3Instruct Notis to approve a GitHub fork workflow run only when the Mintlify preview request identifies a trusted contributor and matching docs change.
- 4Choose an incoming webhook trigger and a channel for reports.
- 5Test with one eligible preview request.
Questions about this workflow
Is every fork run approved?
No. The instruction should require the trusted-contributor and matching-preview conditions before approval.
What if the run is not waiting for approval?
GitHub only approves runs that are awaiting the relevant manual approval.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link Mintlify to GitHub. A trigger fires from one place; an action lands in another.
Mintlify triggers
GitHub actions
Accept a repository invitation
Accepts a pending repository invitation that has been issued to the authenticated user.
List repositories starred by the authenticated user
Deprecated: lists repositories starred by the authenticated user, including star creation timestamps; use 'list repositories starred by the authenticated user' instead.
List stargazers
Deprecated: lists users who have starred a repository; use `list stargazers` instead.
Star a repository for the authenticated user
Deprecated: stars a repository for the authenticated user; use `star a repository for the authenticated user` instead.
Add email for auth user
Adds one or more email addresses (which will be initially unverified) to the authenticated user's github account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted.
Add app access restrictions
Replaces github app access restrictions for an existing protected branch; requires a json array of app slugs in the request body, where apps must be installed and have 'contents' write permissions.
Add a repository collaborator
Adds a github user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly.
Add a repository to an app installation
Adds a repository to a github app installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation.
Connect any two apps with Notis in the middle.
Not just Mintlify and GitHub. Any combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business GitHub.