Automation Unleashed: Scheduled Freezes via API

September 1, 2022

Infrastructure automation just got a major upgrade! We’re excited to announce the ability to schedule upcoming freezes (and their accompanying unfreezes) directly via our API. Now you can programmatically plan deployment windows, maintenance schedules, and release coordination with the same precision you use for the rest of your infrastructure.

What’s New

Create scheduled freezes with a simple API call:

curl -X POST "https://www.mergefreeze.com/api/scheduled_freezes" \
  -d "access_token=your_api_token" \
  -d "account=your-org" \
  -d "repository=your-repo" \
  -d "branch=main" \
  -d "one_off_freeze_at=1672531200" \
  -d "one_off_unfreeze_at=1672542000"

Key capabilities:

  • 📅 Schedule freeze start time with precise timing
  • ⏰ Schedule automatic unfreeze for planned duration
  • 🔄 One-off scheduling for planned maintenance windows
  • 🤖 Full API automation for infrastructure-as-code workflows
  • 📝 Include context with reasons and notes

Common Use Cases

Maintenance Windows

Schedule freezes before planned maintenance, database migrations, or infrastructure updates. The freeze automatically lifts when your maintenance window ends.

CI/CD Integration

Integrate freeze scheduling directly into your deployment pipelines to ensure coordination between multiple services during releases.

Recurring Schedules

Set up regular maintenance windows by scheduling freezes at consistent intervals (weekly deployments, monthly maintenance, etc.).

API Parameters

  • access_token: Your API authentication token
  • account: Your GitHub organization or username
  • repository: Repository name to freeze
  • branch: Branch to freeze (typically “main” or “master”)
  • one_off_freeze_at: Unix timestamp when freeze should start
  • one_off_unfreeze_at: Unix timestamp when freeze should end

Getting Started

  1. Get your API token from your account settings
  2. Calculate Unix timestamps for your desired freeze window
  3. Make the API call with your repository details
  4. The freeze will automatically activate and deactivate at the scheduled times

Learn More

Ready to automate your freeze scheduling?

With programmatic freeze scheduling, your deployment windows become as reliable and predictable as the rest of your infrastructure. Automation meets deployment control! 🤖🚀

Back to Blog