Workflow overview
Why this workflow matters
Useful for software delivery and engineering operations. Relevant for managed services and support workflows.
API Mock Auto-Refresh with GitHub, Postman & OpenAPI Diff Alerts This AlekSystem workflow automates the full API specification update lifecycle whenever changes are pushed to GitHub. It refreshes a Postman mock server, downloads the old and new OpenAPI specs, compares them using openapi-diff, then posts detected API changes directly to the GitHub Pull Request and emails the team. This helps engineering teams instantly validate API contract changes, catch breaking updates early and keep testers/mobile developers synced automatically. Quick Start Setup Import the workflow JSON into your AlekSystem account. Add your GitHub, Postman and Gmail credentials. Update values inside Set: Config node. Create a GitHub webhook pointing to /webhook/api-update. Configure GitHub Actions to run openapi-diff and POST results to /webhook/api-diff-result. Activate the workflow. Push an API spec update and test the automation. What It Does Managing API changes across backend, QA, mobile and frontend teams can become messy when OpenAPI specs are updated manually. This workflow solves that by creating an automated pipeline between GitHub, Postman and your internal notification channels. Whenever code or spec changes are pushed to the develop branch, the workflow first refreshes your Postman Mock Server so testers can immediately work with the latest API behavior. It then downloads both old and new API spec files. Next, an external GitHub Actions process runs openapi-diff to compare the specs and sends the result back into AlekSystem. If changes exist, the workflow cleans the output, posts it as a GitHub Pull Request comment and emails the summary to stakeholders. Who It's For API development teams Mobile app teams relying on mocks QA / testing engineers DevOps teams managing CI/CD pipelines Product teams reviewing API changes Enterprises maintaining multiple consumers of internal APIs Requirements to Use This Workflow Accounts / Tools Needed AlekSystem account (cloud or self-hosted) GitHub repository access Postman account with Mock Server Gmail account for notifications GitHub Personal Access Token GitHub Actions enabled in repository OpenAPI spec files stored in repository Recommended Files /openapi_specs/openapi_old.yaml /openapi_specs/openapi_new.yaml How It Works & Set Up Workflow Logic GitHub Push Trigger ↓ Load Config ↓ Refresh Postman Mock ↓ Download Old Spec ↓ Download New Spec ↓ GitHub Actions runs openapi-diff ↓ Send Result to AlekSystem Webhook ↓ If changes found: ├─ Comment on PR └─ Send Email Else: └─ Stop execution Setup Instructions 1. Import Workflow Upload the JSON file into AlekSystem. 2. Configure Credentials Connect: GitHub Header Auth Postman API Key Gmail OAuth2 3. Update Set: Config Node Replace sample values with your real values: postman.apiKey postman.mockId github.repo github.token github.prId 4. GitHub Webhook Create webhook inside your repository: POST https://your-AlekSystem-domain/webhook/api-update Trigger on: Push events Pull requests (optional) 5. GitHub Actions Setup Use Docker image for openapi-diff and POST response to: https://your-AlekSystem-domain/webhook/api-diff-result 6. Activate Workflow Turn workflow ON and test with a sample OpenAPI change. How To Customize Nodes Set: Config Use environment variables or credentials instead of plain text values. Update Postman Mock Point to another mock server or workspace. Comment to PR Customize PR comment format: Add markdown tables Mention reviewers Highlight breaking changes only Send Summary Email Send to: Product managers QA team Slack email channel Multiple recipients If Node Filter only: Breaking changes Path additions Schema changes Add-ons (Optional Enhancements) Slack notifications instead of email Microsoft Teams alerts Jira ticket creation for breaking changes Auto-approve PR if no breaking changes Save diff history to database Daily digest of API changes Trigger mobile regression tests automatically Publish docs automatically after merge Use Case Examples 1. Mobile App Sync Backend updates endpoints → mobile team receives diff instantly. 2. QA Regression Planning Tester receives changed API list before release testing. 3. API Governance Architecture team tracks breaking changes across repos. 4. Faster PR Reviews Reviewers see API contract changes directly in GitHub comments. 5. Multi-Team Communication Frontend, backend and product teams stay aligned. There can be many more enterprise and SaaS use cases for this workflow. Troubleshooting Guide | Issue | Possible Cause | Solution | |---|---|---| | Webhook not triggering | Wrong GitHub webhook URL | Recheck endpoint | | No PR comment posted | Invalid GitHub token | Regenerate PAT | | Mock not refreshed | Wrong Postman mock ID | Verify mock server ID | | Email not sent | Gmail OAuth expired | Reconnect Gmail | | No diff detected | Same specs or bad file path | Validate YAML files | | Workflow stops early | Empty diff payload | Check GitHub Actions POST body | Need Help? Need help deploying or customizing this workflow for production use? Our AlekSystem workflow developers at WeblineIndia can help you with: AlekSystem workflow implementation GitHub CI/CD integrations API governance automation Postman mock lifecycle systems Enterprise DevOps automations Custom notification pipelines
Best fit
Categories
Services
Use cases
Need another direction?