Buildkite

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
BUILDKITE_API_TOKENYesBuildkite API access token with read_pipelines and read_builds scopes (write_builds to trigger builds) Docs.

Setup

  1. Sign in to Buildkite: Use an existing organization or create one at https://buildkite.com - free plans include API access. You need at least one pipeline to query builds.
  2. Create an API access token: Go to https://buildkite.com/user/api-access-tokens, create a token scoped to your organization, and enable the read_pipelines, read_builds, and read_organizations REST scopes. Add write_builds if you want to trigger builds.
  3. Set the environment variable: Add the token to your .env as BUILDKITE_API_TOKEN=...
  4. Verify access: Run List Organizations, then List Pipelines with your organization slug.

Provider notes

  • Requests authenticate with 'Authorization: Bearer <token>' against https://api.buildkite.com/v2
  • API tokens are scoped per organization and per REST scope - missing scopes return 403
  • Pagination uses page and per_page query parameters (max 100 per page)

Provider API reference.

Tools

ToolAccessDescription
List Organizations<br /><code className="reference-identifier">buildkite__list_organizations</code>ReadList organizations
List Pipelines<br /><code className="reference-identifier">buildkite__list_pipelines</code>ReadList pipelines
Get Pipeline<br /><code className="reference-identifier">buildkite__get_pipeline</code>ReadGet pipeline
List Builds<br /><code className="reference-identifier">buildkite__list_builds</code>ReadList builds
Get Build<br /><code className="reference-identifier">buildkite__get_build</code>ReadGet build
Create Build<br /><code className="reference-identifier">buildkite__create_build</code>WriteCreate build

Verify the connection

Call a read tool such as buildkite__list_organizations with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.