Deployments API

Ruby users: make sure you check out our section on Ruby deployment tracking before you re-invent the wheel.

If you need to manually notify Honeybadger of a deploy, you can use our API directly.

To do this, make a POST request to https://api.honeybadger.io/v1/deploys with the following parameters:

Parameter Description
api_key Your project's API key
deploy[environment] [OPTIONAL] The environment name.
Example: production
deploy[revision] [OPTIONAL] The VCS revision being deployed. Could be a git hash, or a tag name.
Example: 7cd4bac1bd7e2ddf858d10ee86e362c8d8e2f912
deploy[repository] [OPTIONAL] The base URL of the VCS repository. It should be HTTPS-style.
Example: https://github.com/honeybadger-io/honeybadger-ruby
deploy[local_username] [OPTIONAL] The name of the user who is deploying.
Example: Jane

Here's an example curl command to do a deploy notification:

curl --data "deploy[environment]=production&deploy[local_username]=Mary&deploy[revision]=12345&deploy[repository]=https://github.com/user/repo.git&api_key=asdf" "https://api.honeybadger.io/v1/deploys"

If everything goes well, you'll get a response saying {"status":"OK"}