Integrations / Developer tools

Buildkite

Look up builds and job logs, start, rebuild and cancel builds, retry jobs, and trigger workflows from Buildkite build and job events.

9 tools 12 trigger events

Tools

buildkite.list_builds

List a pipeline's builds, newest first.

pipeline*branchstatecommitper_page

buildkite.get_build

Get a build by its number, with its jobs and their states.

pipeline*number*

buildkite.get_job_log

Get the log output of a job in a build.

pipeline*number*job_id*

buildkite.create_build writes

Start a new build of a pipeline.

pipeline*commit*branch*messageenv

buildkite.rebuild_build writes

Rebuild a build as a new build.

pipeline*number*

buildkite.cancel_build writes

Cancel a scheduled or running build.

pipeline*number*

buildkite.retry_job writes

Retry a failed or timed-out job. Each job can be retried once.

pipeline*number*job_id*

buildkite.api_get

Send a GET request to any Buildkite API path under https://api.buildkite.com/v2/organizations/{organization} and return the response. For endpoints the named tools don't cover.

path*params

buildkite.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Buildkite API path under https://api.buildkite.com/v2/organizations/{organization}.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any Buildkite API path.

Connect

  1. In Buildkite, open Personal Settings → API Access Tokens and create a token for your organization with the read_pipelines, read_builds and read_build_logs scopes, plus write_builds if workflows start, rebuild, cancel or retry builds.
  2. Paste it as the connection's API token, and set the organization to its slug, as in buildkite.com/acme.
  3. To trigger workflows, open Settings → Notification Services, add a Webhook with the request URL shown on the connection page, set its Token to be sent as an X-Buildkite-Signature, choose the events and pipelines, and paste the token on the connection.

Credentials

API access token Webhook token

Buildkite API docs

Triggers

In Buildkite, open Settings → Notification Services, add a Webhook with this URL, send its Token as an X-Buildkite-Signature, choose the events and pipelines, and paste the token on this connection.

Events

build.scheduledbuild.runningbuild.failingbuild.finishedbuild.skippedjob.scheduledjob.startedjob.finishedjob.activatedagent.connectedagent.lostagent.disconnected
 trigger
kind: buildkite
connection: buildkite
events: [build.scheduled]
pipelines: [...]
branches: [...]
states: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.

Start free trial Talk to us