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.

Buildkite publishes 2 APIs on the APIs.io network: REST API and Agent API. Tagged areas include CI/CD, Continuous Integration, Continuous Delivery, DevOps, and Pipelines.

The Buildkite catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Buildkite’s developer surface includes authentication, CLI, changelog, developer portal, documentation, getting-started guide, signup flow, and 56 more developer resources.

🌐 Visit website 📡 Source on GitHub

67.8/100 strong ▬ flat Agent 71/100 agent native Full breakdown ↓
scored 2026-07-20 · rubric v0.4

5 APIs 23 Features

CI/CDContinuous IntegrationContinuous DeliveryDevOpsPipelinesHybrid CIBuild AutomationTest EnginePackage RegistriesAgentsGraphQLRESTMCPWebhooks

API Rating

API Evangelist Rating How this is scored →
scored 2026-07-20 · rubric v0.4

Composite quality — 67.8/100 · strong

Contract Quality 14.8 / 25

Developer Ergonomics 14.3 / 20

Commercial Clarity 15.8 / 20

Operational Transparency 6.2 / 13

Governance 10.4 / 12

Discoverability 6.3 / 10

Agent readiness — 71/100 · agent native

Machine-Readable Contract 18 / 18

Agentic Access Contract 15 / 15

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 4 / 4

Consent & Bot Identity 0 / 3

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/buildkite-com: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

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

Scroll for all 9

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

Get Started 3

Portal, sign-up, and the first successful call

Portal

Portal

GettingStarted

GettingStarted

Signup

Signup

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

JSONSchema

JSONSchema

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

WellKnown

MCPServer

LLMsTxt

Design & Contract 16

Pagination, idempotency, versioning, errors, and events

Lifecycle

Conventions

Conformance

ErrorCatalog

DataModel

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Vocabulary

Spectral

Scroll for all 16

Build 16

SDKs, sample code, and the tooling you integrate with

Packages

Packages

CLI

CLI

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

SourceCode

CLI

SDKs

SDKs

Tools

Tools

Tools

Tools

Tools

Tools

Tools

SourceCode

Scroll for all 16

Access & Security 7

Authentication, authorization, and security posture

TrustCenter

DomainSecurity

Authentication

OAuthScopes

SecurityPolicy

TrustCenter

Authentication

Scroll for all 7

Operate 7

Status, limits, changes, and where to get help

ChangeLog

StatusPage

ChangeLog

Forums

Support

RateLimits

RateLimits

Scroll for all 7

Commercial 5

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

FinOps

Company 1

The organization behind the API

Blog

Blog

Other 2

Properties that don't map to a standard resource type

Overlay

Overlay

Overlay

Overlay

Source (apis.yml)

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