Verify GitHub Access Before Mintlify Maintenance
A quick access check can prevent a scheduled docs workflow from failing for a reason unrelated to the work.
Trigger
Recurring schedule
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Action
Check a token
Checks if a github app or oauth access token is valid for the specified client id and retrieves its details, typically to verify its active status and grants.
Why this helps
Authentication failures are disruptive because they appear only after a routine task has already started.
- Adds a lightweight preflight to recurring work.
- Surfaces access problems before they block maintenance.
- Reduces confusing failure notifications.
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 by message.
- 3Instruct Notis to check the GitHub token before scheduled Mintlify maintenance and report if access is invalid.
- 4Pick a recurring schedule and a channel for reports.
- 5Test it with the connected GitHub account.
Questions about this workflow
Does this repair the token?
No. It checks validity and reports the result so access can be repaired.
Why run it before maintenance?
It separates authentication problems from actual documentation or repository problems.
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
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Accept a repository invitation
Accepts a pending repository invitation that has been issued to the authenticated user.
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
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.
Mintlify and GitHub, or any other 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.