DEVOPS

Pre-deploy budget gate that blocks preview builds when the team is over quota

Exposes a webhook the CI pipeline calls before triggering a Vercel preview build; it checks remaining build-minute headroom and returns an allow or deny decision.

CategoryDevOps
Enginesim
Difficultyintermediate
Triggerwebhook
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerCI calls budget-gate HTTP webhook pre-deployHTTP webhook
  • ActionRead month-to-date usage and capPostgreSQLPostgres
  • LogicApply policy: protected branch or enough headroom?
  • ActionRecord gate decision for reportingPostgreSQLPostgres
  • OutputReturn allow/deny decision to CIHTTP webhook

What it does

Acts as a gate the CI pipeline asks before it spends build minutes. Given the branch and remaining month, it checks the team's headroom against the monthly cap and answers allow or deny, so low-priority preview builds stop automatically when the budget is nearly exhausted.

When to use it

Use it in the final days of a billing cycle when you want production and release branches to keep deploying but are willing to pause routine feature-branch previews to avoid overage charges. The gate makes that policy automatic instead of a manual freeze.

How it works

  1. 1The CI step calls the gate's HTTP webhook with the branch name and deploy context before triggering Vercel.
  2. 2The flow reads month-to-date build-minute consumption and the configured cap from Postgres.
  3. 3A logic step computes remaining headroom and applies policy: protected branches always pass, others are denied once headroom drops below the reserve.
  4. 4It records the decision and the requesting branch to Postgres for reporting.
  5. 5It returns an allow or deny response to the caller, including the reason and remaining headroom, which CI uses to proceed or skip the deploy.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect HTTP webhookTrigger any URL on agent actions.
  2. 2
    Connect PostgresAny Postgres URL — query, write, migrate.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.