Sign in

API reference

Deploys

Endpoint POST /api/v1/deploys

A deploy marks when a release reached an environment. The Releases page shows the last deploy per release, and the release is created if it does not exist yet.

1Request

Secret key in X-Blipit-Key. Body: version (required), environment (required; letters, digits, dot, dash, underscore, up to 64), url (optional http or https address).

sh
curl https://in.blipit.io/api/v1/deploys \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <secret key>" \
  -d '{"version":"shop@1.4.2","environment":"production","url":"https://shop.example.com"}'

2Responses

200 {id, version, environment}. 400 for a missing version, a bad environment or a URL that is not http(s). 401 or 403 for the wrong key.

Good to know

  • The CLI equivalent is blipit deploys new shop@1.4.2 --env production.

Stuck? Email support@blipit.io. Keys and the exact DSN for each project are under API keys in app.blipit.io.