Spaces:
No application file
No application file
| title: "GitHub Actions & CI/CD Scheduling and Availability API" | |
| emoji: "🤖" | |
| colorFrom: blue | |
| colorTo: indigo | |
| sdk: gradio | |
| sdk_version: "4.44.0" | |
| app_file: app.py | |
| pinned: false | |
| license: mit | |
| # GitHub Actions & CI/CD Scheduling and Availability API | |
| Stop waking up to failed GitHub Actions runs because your self-hosted runner was offline or your cron schedule didn't account for maintenance windows. The GitHub Actions & CI/CD Scheduling and Availability API gives you programmatic control over when your workflows actually run, so you never waste a precious runner minute again. | |
| This REST API solves the two biggest headaches in CI/CD automation: complex scheduling and runner availability. Instead of relying on GitHub's basic cron syntax or guessing when your runners will be free, you get a set of API endpoints to define timezone-aware schedules, check runner availability in real time, and conditionally trigger workflows only when resources are ready. It's the missing layer for teams that need reliable, predictable pipeline execution without manual oversight. | |
| ## What's Included | |
| - REST API endpoint to create, update, and delete schedules with cron, interval, or calendar-based recurrence including timezone support | |
| - Availability API to query runner status (online, busy, idle) and block workflow execution until a runner is free | |
| - Conditional trigger logic that fires workflows based on availability windows, resource tags, or custom webhook conditions | |
| - Webhook callbacks to notify your monitoring tools when a scheduled run is skipped or delayed due to unavailability | |
| - Authentication via API key with granular permissions per repository or organization (supports GitHub App installation) | |
| ## Who Is This For | |
| - DevOps engineers managing GitHub Actions across multiple repositories who need advanced scheduling beyond cron | |
| - Teams with self-hosted runners that go offline for maintenance or scale up/down – avoid failed builds when runners aren't ready | |
| - CI/CD pipeline architects designing complex deployment windows that must align with business hours or low-traffic periods | |
| - Freelancers and agencies juggling client workflows – automate scheduling without logging into each repo's settings | |
| ## How It Works | |
| Purchase and instantly receive your unique API key. Integrate the REST API into your workflow files using a simple curl or script step – define schedules or availability checks as a pre-run condition. The API returns a decision (execute/skip/delay) that you handle in your YAML, with full audit logs via webhook. No additional infrastructure needed beyond your GitHub Actions runner. | |
| ## Frequently Asked Questions | |
| **Does this API replace GitHub's native schedule trigger?** | |
| No – it works alongside it. Use GitHub's cron trigger to start a workflow that calls our API to decide if it should actually run based on real-time availability and your custom schedule rules. | |
| **How is runner availability determined?** | |
| The API checks the status of runners associated with your GitHub App installation (or provided via self-hosted runner labels). It returns a boolean and detailed status (online, offline, busy) for up to 100 runners per request. | |
| **Is this compatible with GitHub Enterprise (self-hosted)?** | |
| Yes – as a REST API, it works with any GitHub Actions instance (cloud or enterprise) as long as you can make HTTP requests from your workflow. For enterprise, you'll need network access to the API endpoint. | |
| **What happens if my API key is compromised?** | |
| You can revoke and regenerate keys instantly from your account dashboard. We also support IP whitelisting on the API key to limit usage to your runner's IPs. | |
| **Is there a free tier or trial?** | |
| This is a one-time purchase – no subscription. You get 10,000 API calls per day included. Use it forever on unlimited repositories. Additional usage can be purchased via add-on packs. | |
| ## What You Get | |
| - Instant digital download | |
| - Complete REST API with full documentation | |
| - Free updates for life — pay once, own forever | |
| - Setup guide and usage instructions | |
| **Stop guessing when your pipelines will run – buy the GitHub Actions & CI/CD Scheduling and Availability API now and programmatically control every workflow execution.** | |
| ## Get the Full Version | |
| - **Demo**: Free on Hugging Face Spaces | |
| - **[Buy on Gumroad](https://gearreviewer7.gumroad.com/l/lireoh)** — Instant download | |
| - **[Buy Now](https://buy.stripe.com/aFabJ112D1g01de33mcZc0L)** — Secure checkout | |
| --- | |
| *Built with [FORGE-X](https://github.com/WealthFromAI)* | |