Buildkite

Buildkite is a hybrid CI/CD platform that combines a hosted control plane (pipelines.buildkite.com) with self-hosted or Buildkite-Hosted agents that run jobs on customer-controlled infrastructure. The platform spans three core products — Pipelines, Test Engine, and Package Registries — and exposes them through a v2 REST API, a Relay-compliant GraphQL API at graphql.buildkite.com/v1, an Agent API at agent.buildkite.com/v3 consumed by the open-source Go agent, webhooks, and an official MCP server that surfaces those APIs to AI coding agents. Customers route work to specific agent pools through clusters and queues, define pipelines as YAML with dynamic uploads, and integrate with the major source control, cloud, identity, secrets, and observability vendors.

5 APIs 23 Features

CI/CDContinuous IntegrationContinuous DeliveryDevOpsPipelinesHybrid CIBuild AutomationTest EnginePackage RegistriesAgentsGraphQLRESTMCPWebhooks

APIs

Buildkite REST API

Programmatic access to Buildkite Pipelines covering organizations, pipelines, builds, jobs, artifacts, annotations, agents, clusters, queues, agent tokens, teams, pipeline templ...

Buildkite GraphQL API

GraphQL endpoint that returns deeply nested data on organizations, pipelines, builds, jobs, agents, clusters, queues, teams, audit events, suites, test executions, and package r...

Buildkite Agent API

Backplane consumed by the Buildkite Agent (open source, Go) to register, deregister, accept and finish jobs, upload artifacts, stream job logs, and emit metrics for cluster auto...

Buildkite Webhooks

Outbound HTTP notifications fired in response to build, job, agent, ping, deployment, and package events across Pipelines, Test Engine, and Package Registries. Verified with the...

Buildkite MCP Server

Official Model Context Protocol server that exposes Buildkite REST API surfaces (pipelines, builds, jobs, agents, artifacts, annotations) as MCP tools and toolsets for AI coding...

Collections

Buildkite REST API

POSTMAN

Buildkite Agent API

OPEN

Buildkite REST API

OPEN

Arazzo Workflows

Buildkite Build Failure Triage

Inspect a finished build, then pull its annotations and artifacts for triage.

ARAZZO

Buildkite Cancel Running Build

Find the latest running build on a pipeline and cancel it.

ARAZZO

Buildkite Collect Build Artifacts

Look up a build, confirm it finished, then list its artifacts.

ARAZZO

Buildkite Fetch Job Log

Read a build, pick a finished job, and fetch its log output.

ARAZZO

Buildkite Provision Pipeline And First Build

Create a pipeline in an organization, then trigger its first build.

ARAZZO

Buildkite Rebuild Latest Build

Find the most recent build on a pipeline, rebuild it, then poll the new build.

ARAZZO

Buildkite Retry Failed Job

Find a failed job in a build, retry it, then poll the build to completion.

ARAZZO

Buildkite Stop Disconnected Agent

List agents, inspect one, and stop it when it is no longer connected.

ARAZZO

Buildkite Trigger And Poll Build

Create a build on a pipeline, then poll until it reaches a terminal state.

ARAZZO

GraphQL

Buildkite GraphQL API

GraphQL endpoint that returns deeply nested data on organizations, pipelines, builds, jobs, agents, clusters, queues, teams, audit events, suites, test executions, and package r...

GRAPHQL

Pricing Plans

Buildkite Com Plans Pricing

4 plans

PLANS

Rate Limits

Buildkite Com Rate Limits

0 limits

RATE LIMITS

FinOps

Buildkite Com Finops

FINOPS

Features

Hybrid CI/CD — self-hosted agents on customer infrastructure plus optional Buildkite Hosted Agents

Pipelines as YAML with dynamic pipeline upload from inside jobs

Open source agent (Go) running on Linux, macOS, Windows, FreeBSD

Clusters and Queues for routing jobs to specific agent pools

Pipeline Templates for standardizing pipelines across teams

Rules engine for organizational policies and automation

Annotations, artifacts, and job logs as first-class API resources

Buildkite Hosted Agents — Linux, Mac M4, with cache volumes and tunable vCPU sizes

Test Engine with flaky test management, real-time test analytics, and intelligent test splitting

Test Engine duration-threshold monitor for long-running test alerts

Package Registries for npm, PyPI, RubyGems, Maven, Container, Debian, RPM, Terraform, Helm

SLSA provenance, license checks, and threat scanning on Enterprise Package Registries

OIDC and OAuth Token Exchange (RFC 8693) for short-lived API tokens from identity providers

bktec build tooling with automatic OIDC token generation

Per-user API rate limits with org-wide caps

GraphQL Portals for scoped, schema-filtered API access

Batch retry API for failed jobs with optional state filtering

GitHub webhook trigger expansion (PR reviews, releases, issue comments, deployment status)

Build page redesign with searchable job list and state-based filters

SCIM, SAML, ADFS for Enterprise identity

Audit logs and build exports for compliance and FinOps

Official MCP server for AI coding agent integration

Buildkite Skills for Claude Code and Cursor

Integrations

GitHub, GitLab, Bitbucket source control providers

GitHub App, Apps for GitLab and Bitbucket Cloud

AWS (Elastic CI Stack, EC2, ECS, EKS, Lambda autoscaler)

Google Cloud (GCE, GKE)

Microsoft Azure (AKS, Azure DevOps)

Kubernetes via agent-stack-k8s

Terraform provider community modules

Slack, Microsoft Teams, email notifications

PagerDuty, Opsgenie, Datadog observability

Honeycomb, OpenTelemetry tracing

1Password, HashiCorp Vault, AWS Secrets Manager secrets

Sentry, Rollbar error tracking

Snyk, Aikido, Semgrep security scanning

Docker, Docker Hub, ECR, GCR, GHCR container registries

Test Engine integrations for RSpec, Jest, pytest, JUnit, Go, Cypress, Playwright

Package Registries for npm, PyPI, RubyGems, Maven, Container, Debian, RPM, Terraform, Helm

OIDC integrations with AWS, GCP, Azure, HashiCorp Vault

OAuth Token Exchange (RFC 8693) for identity provider integrations

Buildkite MCP Server for Claude, Cursor, and other AI coding agents

Semantic Vocabularies

Buildkite Com Context

34 classes · 5 properties

JSON-LD

API Governance Rules

Buildkite API Rules

7 rules · 5 errors 2 warnings

SPECTRAL

JSON Structure

Buildkite Com Pipeline Structure

0 properties

JSON STRUCTURE

Example Payloads

Buildkite Create Build Example

2 fields

EXAMPLE

Buildkite Graphql Builds Example

2 fields

EXAMPLE

Buildkite List Agents Example

2 fields

EXAMPLE

Resources

PostmanWorkspace

PostmanWorkspace

Documentation

GettingStarted

TermsOfService

PrivacyPolicy

SecurityPolicy

TrustCenter

Authentication

GitHubOrganization

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Buildkite REST API
  version: v2
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: User
    type: folder
  items:
  - info:
      name: Get The Current User
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/user
    docs: Get The Current User
- info:
    name: Access Token
    type: folder
  items:
  - info:
      name: Get The Current Access Token
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/access-token
    docs: Get The Current Access Token
  - info:
      name: Revoke The Current Access Token
      type: http
    http:
      method: DELETE
      url: https://api.buildkite.com/v2/access-token
    docs: Revoke The Current Access Token
- info:
    name: Meta
    type: folder
  items:
  - info:
      name: Get Meta Information
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/meta
    docs: Get Meta Information
- info:
    name: Organizations
    type: folder
  items:
  - info:
      name: List Organizations
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations
    docs: List Organizations
  - info:
      name: Get An Organization
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: Get An Organization
- info:
    name: Pipelines
    type: folder
  items:
  - info:
      name: List Pipelines
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipelines
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: List Pipelines
  - info:
      name: Create A Pipeline
      type: http
    http:
      method: POST
      url: https://api.buildkite.com/v2/organizations/:org/pipelines
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      body:
        type: json
        data: '{}'
    docs: Create A Pipeline
  - info:
      name: Get A Pipeline
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
    docs: Get A Pipeline
  - info:
      name: Update A Pipeline
      type: http
    http:
      method: PATCH
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
    docs: Update A Pipeline
  - info:
      name: Delete A Pipeline
      type: http
    http:
      method: DELETE
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
    docs: Delete A Pipeline
- info:
    name: Builds
    type: folder
  items:
  - info:
      name: List Builds For A Pipeline
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
    docs: List Builds For A Pipeline
  - info:
      name: Create A Build
      type: http
    http:
      method: POST
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
    docs: Create A Build
  - info:
      name: Get A Build
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds/:number
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
      - name: number
        value: ''
        type: path
        description: Build number
    docs: Get A Build
  - info:
      name: Cancel A Build
      type: http
    http:
      method: PUT
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds/:number/cancel
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
      - name: number
        value: ''
        type: path
        description: Build number
    docs: Cancel A Build
  - info:
      name: Rebuild A Build
      type: http
    http:
      method: PUT
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds/:number/rebuild
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
      - name: number
        value: ''
        type: path
        description: Build number
    docs: Rebuild A Build
- info:
    name: Jobs
    type: folder
  items:
  - info:
      name: Retry A Job
      type: http
    http:
      method: PUT
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds/:number/jobs/:job/retry
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
      - name: number
        value: ''
        type: path
        description: Build number
      - name: job
        value: ''
        type: path
        description: Job UUID
    docs: Retry A Job
  - info:
      name: Get Job Log Output
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds/:number/jobs/:job/log
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
      - name: number
        value: ''
        type: path
        description: Build number
      - name: job
        value: ''
        type: path
        description: Job UUID
    docs: Get Job Log Output
- info:
    name: Artifacts
    type: folder
  items:
  - info:
      name: List Artifacts For A Build
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds/:number/artifacts
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
      - name: number
        value: ''
        type: path
        description: Build number
    docs: List Artifacts For A Build
- info:
    name: Annotations
    type: folder
  items:
  - info:
      name: List Annotations For A Build
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipelines/:pipeline/builds/:number/annotations
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: pipeline
        value: ''
        type: path
        description: Pipeline slug
      - name: number
        value: ''
        type: path
        description: Build number
    docs: List Annotations For A Build
- info:
    name: Agents
    type: folder
  items:
  - info:
      name: List Agents
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/agents
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: List Agents
  - info:
      name: Get An Agent
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/agents/:id
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: id
        value: ''
        type: path
        description: Agent UUID
    docs: Get An Agent
  - info:
      name: Stop An Agent
      type: http
    http:
      method: PUT
      url: https://api.buildkite.com/v2/organizations/:org/agents/:id/stop
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: id
        value: ''
        type: path
        description: Agent UUID
    docs: Stop An Agent
- info:
    name: Clusters
    type: folder
  items:
  - info:
      name: List Clusters
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/clusters
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: List Clusters
- info:
    name: Queues
    type: folder
  items:
  - info:
      name: List Queues For A Cluster
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/clusters/:cluster/queues
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: cluster
        value: ''
        type: path
        description: Cluster UUID
    docs: List Queues For A Cluster
- info:
    name: Agent Tokens
    type: folder
  items:
  - info:
      name: List Agent Tokens For A Cluster
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/clusters/:cluster/tokens
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
      - name: cluster
        value: ''
        type: path
        description: Cluster UUID
    docs: List Agent Tokens For A Cluster
- info:
    name: Teams
    type: folder
  items:
  - info:
      name: List Teams
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/teams
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: List Teams
- info:
    name: Pipeline Templates
    type: folder
  items:
  - info:
      name: List Pipeline Templates
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/pipeline-templates
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: List Pipeline Templates
- info:
    name: Rules
    type: folder
  items:
  - info:
      name: List Organization Rules
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/rules
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: List Organization Rules
- info:
    name: Emojis
    type: folder
  items:
  - info:
      name: List Custom Emojis
      type: http
    http:
      method: GET
      url: https://api.buildkite.com/v2/organizations/:org/emojis
      params:
      - name: org
        value: ''
        type: path
        description: Organization slug
    docs: List Custom Emojis
bundled: true