Docs
Back to changelog

Deploy hooks

feature

Deploy hooks

You can now trigger a deployment of any environment with an HTTP POST request — no commit required.

Deploy hooks are useful for external content sources (a CMS, a docs content repo), scheduled rebuilds, or any system that needs to kick off a deployment without a code push.

How to create a hook

  1. Open the environment and go to its Settings tab.
  2. Under Deploy hooks, select Create deploy hook.
  3. Give it a name and confirm.
  4. Copy the URL immediately — it's shown only once.

Requires Owner or Admin role.

Triggering a deployment

curl -X POST "https://dashboard.velumi.com/api/deploy-hooks/<your-hook-url>"
  • 200 — deployment started.
  • 202 — deployment queued (one was already running; it deploys automatically when the current one finishes).
  • If the environment is stopped, the hook returns 409 — start the environment first.

Security

The URL is the credential — anyone with it can trigger a deployment of that environment. Store it in your CI/CD secrets, not in plain text. If it leaks, revoke it from the Settings tab and create a new one.

Back to changelog