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 23 API contracts indexed on the APIs.io network, including Access Token API, Agent Tokens API, Agents API, and 20 more. Tagged areas include CI/CD, Continuous Integration, Continuous Delivery, DevOps, and Pipelines.

The Buildkite catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 3 Spectral governance rulesets.

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

🌐 Visit website 📡 Profile data on GitHub

72.8/100 exemplar ▬ flat Agent 51/100 agent ready Front door AI 5/6 prominent Heartbeat 100/100 alive saas Full breakdown ↓
scored 2026-11-02 · rubric v0.26.0 · Show this score on your site →

AccessFreemiumSelf serve⚡ Free to try

2 published contracts 1 MCP Servers 23 Features

CI/CD Continuous Integration Continuous Delivery DevOps PipelinesHybrid CIBuild AutomationTest EnginePackage RegistriesAgents GraphQL REST MCP Webhook Australia

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Software Release & Deployment Management

BC-4210

AgentsAnnotationsArtifactsBuildsJobsPipeline Templates

POST /organizations/{org}/pipelines/{pipeline}/builds PUT /organizations/{org}/pipelines/{pipeline}/builds/{number}/rebuild PUT /organizations/{org}/pipelines/{pipeline}/builds/{number}/jobs/{job}/retry GET /organizations/{org}/pipelines/{pipeline}/builds/{number}/jobs/{job}/log

What people ask Buildkite 19

The questions people put to an LLM, and the jobs they hand an agent, that Buildkite's APIs answer — each one linked to the operation that does it. Generated by API Evangelist

Buildkite Pipelines API List an organization's pipelines “What pipelines exist in my organization?” Create a new pipeline “How do I create a pipeline for a repository through the API?” Get one pipeline's settings “Can I see the repository and default branch a specific pipeline uses?” Update an existing pipeline “How do I change the settings of a pipeline that already exists?”

Buildkite Builds API List builds for a pipeline “How do I see the recent builds of one of my pipelines?” Trigger a new build of a pipeline “How do I trigger a new build through the Buildkite API?” Get one build by number “What's the state of a specific build number?” Cancel a running build “How do I cancel a build that's still running?”

Buildkite Agents API List an organization's agents “Which build agents are connected to my organization right now?” Get details of one agent “What's the status and hostname of a specific build agent?” Stop a running agent “How do I stop a build agent remotely?”

Buildkite Organizations API List organizations I belong to “Which Buildkite organizations can my token access?” Get one organization “Can I fetch the details of a single organization by its slug?”

Buildkite Access Token API Inspect the API access token in use “Which scopes does the Buildkite API token I'm using right now have?” Revoke the API access token in use “How do I revoke the access token I'm currently authenticating with?”

Buildkite Jobs API Retry a job in a build “How do I retry a single failed job without rebuilding everything?” Get a job's log output “How do I download the log output of a job?”

Buildkite Meta API Get Buildkite platform meta information “What general meta information does the Buildkite API publish about the platform?”

Buildkite Emojis API List an organization's custom emojis “What custom emojis has my organization uploaded?”

Buildkite Clusters API List an organization's clusters “Which clusters are set up in my Buildkite organization?”

Buildkite Artifacts API List artifacts produced by a build “Which files did a build upload as artifacts?”

Buildkite Annotations API List annotations on a build “How do I read the annotations steps added to a build?”

Buildkite Teams API List an organization's teams “Which teams exist in my Buildkite organization?”

Showing 12 of 19 APIs with phrasing — see every API.

Kin Score

Kin Score How this is scored →
scored 2026-11-02 · rubric v0.26.0

Composite quality — 72.8/100 · exemplar

Contract Quality 12.4 / 19

Developer Ergonomics 10.9 / 15

Access Clarity 15.0 / 15

Operational Transparency 6.2 / 10

Contract Governance 2.9 / 9

Discoverability 5.1 / 8

Regulatory Posture 5.9 / 15

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 51/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

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 6 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 6 / 6

Protected Resource Metadata 5 / 5

Registration Without a Human 6 / 6

Agentic Commerce Well-Known Document 0 / 5

Pagination 0 / 5

Distinct Operations 3 / 3

MCP Tool Quality 6 / 6

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Show this score on your site.

It updates itself when the score changes. Paste this where you link to your API docs:

<a href="https://apis.io/providers/buildkite-com/"><img src="https://apis.io/badge/buildkite-com/card.svg" alt="Buildkite on APIs.io — Kin Score by API Evangelist"></a>

Other styles, a README pill and a shields.io endpoint are on the badge page.

Raise your score.

Agent readiness — checks not met, largest first (exact, from this profile):

Idempotency +9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card +8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Request/Response Examples +7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link
Pagination +5 pts — share of collection GETs (an array, or one wrapped in data/items/results ...) that declare a page/limit/offset/cursor parameter, a Link header or a next/cursor field; na with no collection GETs
Agent Skills +5 pts — skills artifact present, graded by who authored it
Agentic Commerce Well-Known Document +5 pts — a parsing /.well-known/ucp.json or acp.json declaring a version and at least one service — `self` when its endpoints are on the provider's own domain, `platform` when they are on a vendor's

3 more unmet checks in the Agent Readiness table above.

Kin Score — facets with the most composite points still available (weight × headroom):

Contract Quality scores 66.0 — up to +8.5 composite points
Contract Governance scores 31.8 — up to +8.2 composite points
Developer Ergonomics scores 72.6 — up to +5.5 composite points

Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/buildkite-com/apis.yml: open an issue on github.com/api-evangelist/buildkite-com to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

Market	Position	Depth	Registered MCP server	Declares compatibility
Infrastructure-as-Code Provider Registries (Terraform, OpenTofu, Pulumi)	builds-on	51.8	-	1
GitHub Marketplace (GitHub-native publisher layer)	builds-on	51.8	-	1
GraphQL Ecosystem (Foundation, graphql.org listings, public GraphQL APIs)	builds-on	51.8	-	1
Backstage Plugin Directory	builds-on	51.8	-	1
Raycast Store Extensions (first-party publishers + community-wrapped products)	builds-on	51.8	-	1
Jenkins Plugins + CD Foundation Landscape	builds-on	51.8	-	1

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 8

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

GraphQL

tagged — the provider's own APIs.json carries the standard as a tag; implementation not verified

Model Context Protocol (MCP)

measured — observed by APIs.io (verified)

REST

tagged — the provider's own APIs.json carries the standard as a tag; implementation not verified

SCIM 2.0

prose — states compatibility; nothing published to check it against

5 core of 24 operations graded · api-commons/identity

OAuth 2.0 Protected Resource Metadata

measured — observed by APIs.io (verified)

Dynamic Client Registration

measured — observed by APIs.io (published)

OpenAPI

measured — observed by APIs.io (published)

OAuth 2.0

measured — observed by APIs.io (declared)

APIs 23

Individual APIs this provider publishes, each with its own machine-readable definition.

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...

Buildkite Access Token API

The Access Token API from Buildkite — 1 operation(s) for access token.

Buildkite Agent Tokens API

The Agent Tokens API from Buildkite — 1 operation(s) for agent tokens.

Buildkite Agents API

The Agents API from Buildkite — 3 operation(s) for agents.

Buildkite Annotations API

The Annotations API from Buildkite — 1 operation(s) for annotations.

Buildkite Artifacts API

The Artifacts API from Buildkite — 1 operation(s) for artifacts.

Buildkite Builds API

The Builds API from Buildkite — 4 operation(s) for builds.

Buildkite Clusters API

The Clusters API from Buildkite — 1 operation(s) for clusters.

Buildkite Emojis API

The Emojis API from Buildkite — 1 operation(s) for emojis.

Buildkite Jobs API

The Jobs API from Buildkite — 2 operation(s) for jobs.

Buildkite Meta API

The Meta API from Buildkite — 1 operation(s) for meta.

Buildkite Metrics API

The Metrics API from Buildkite — 1 operation(s) for metrics.

Buildkite Organizations API

The Organizations API from Buildkite — 2 operation(s) for organizations.

Buildkite Pipeline Templates API

The Pipeline Templates API from Buildkite — 1 operation(s) for pipeline templates.

Buildkite Pipelines API

The Pipelines API from Buildkite — 2 operation(s) for pipelines.

Buildkite Queues API

The Queues API from Buildkite — 1 operation(s) for queues.

Buildkite Rules API

The Rules API from Buildkite — 1 operation(s) for rules.

Buildkite Stacks API

The Stacks API from Buildkite — 1 operation(s) for stacks.

Buildkite Teams API

The Teams API from Buildkite — 1 operation(s) for teams.

Buildkite User API

The User API from Buildkite — 1 operation(s) for user.

Scroll for all 23

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

Buildkite REST API

POSTMAN

Open Collections 21

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Buildkite Agent API

OPEN COLLECTION

Buildkite Agent Access Token API

OPEN COLLECTION

Buildkite Agent Access Token Agent Tokens API

OPEN COLLECTION

Buildkite Agent Access Token Agents API

OPEN COLLECTION

Buildkite Agent Access Token Annotations API

OPEN COLLECTION

Buildkite Agent Access Token Artifacts API

OPEN COLLECTION

Buildkite Agent Access Token Builds API

OPEN COLLECTION

Buildkite Agent Access Token Clusters API

OPEN COLLECTION

Buildkite Agent Access Token Emojis API

OPEN COLLECTION

Buildkite Agent Access Token Jobs API

OPEN COLLECTION

Buildkite Agent Access Token Meta API

OPEN COLLECTION

Buildkite Agent Access Token Metrics API

OPEN COLLECTION

Buildkite Agent Access Token Organizations API

OPEN COLLECTION

Buildkite Agent Access Token Pipeline Templates API

OPEN COLLECTION

Buildkite Agent Access Token Pipelines API

OPEN COLLECTION

Buildkite Agent Access Token Queues API

OPEN COLLECTION

Buildkite Agent Access Token Rules API

OPEN COLLECTION

Buildkite Agent Access Token Stacks API

OPEN COLLECTION

Buildkite Agent Access Token Teams API

OPEN COLLECTION

Buildkite Agent Access Token User API

OPEN COLLECTION

Buildkite REST API

OPEN COLLECTION

Scroll for all 21

Arazzo Workflows 9

Multi-step API workflows described with the Arazzo specification.

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

Scroll for all 9

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Buildkite MCP Server

Buildkite operates an official Model Context Protocol server that exposes the REST API (organizations, clusters, agents, pipelines, builds, jobs, artifacts, annotations, logs, T...

MCP SERVER

GraphQL 1

GraphQL schemas published by this provider.

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 1

Published pricing tiers and plan structures.

Buildkite Com Plans Pricing

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Buildkite Com Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Buildkite Com Finops

FINOPS

Features 23

Notable capabilities this provider offers.

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

Scroll for all 23

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Buildkite Com Webhooks

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Buildkite Com Context

34 classes · 5 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

Buildkite — jsonschema rules

5 rules · 4 warnings 1 info

SPECTRAL

Buildkite API Rules

12 rules · 11 errors 1 info

SPECTRAL

Buildkite — buildkite rules

7 rules · 5 errors 2 warnings

SPECTRAL

OpenAPI Overlays 22

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

Buildkite Com Access Token Api Phrasing Overlay

3 actions · phrasing · buildkite-com-access-token-api-openapi.yml

GENERATED

Buildkite Com Agent Api Overlay

1 action · update · buildkite-agent-api-openapi.yml

DERIVED

Buildkite Com Agent Tokens Api Phrasing Overlay

2 actions · phrasing · buildkite-com-agent-tokens-api-openapi.yml

GENERATED

Buildkite Com Agents Api Overlay

0 actions · update

DERIVED

Buildkite Com Agents Api Phrasing Overlay

4 actions · phrasing · buildkite-com-agents-api-openapi.yml

GENERATED

Buildkite Com Annotations Api Phrasing Overlay

2 actions · phrasing · buildkite-com-annotations-api-openapi.yml

GENERATED

Buildkite Com Artifacts Api Phrasing Overlay

2 actions · phrasing · buildkite-com-artifacts-api-openapi.yml

GENERATED

Buildkite Com Builds Api Phrasing Overlay

6 actions · phrasing · buildkite-com-builds-api-openapi.yml

GENERATED

Buildkite Com Clusters Api Phrasing Overlay

2 actions · phrasing · buildkite-com-clusters-api-openapi.yml

GENERATED

Buildkite Com Emojis Api Phrasing Overlay

2 actions · phrasing · buildkite-com-emojis-api-openapi.yml

GENERATED

Buildkite Com Jobs Api Phrasing Overlay

3 actions · phrasing · buildkite-com-jobs-api-openapi.yml

GENERATED

Buildkite Com Meta Api Phrasing Overlay

2 actions · phrasing · buildkite-com-meta-api-openapi.yml

GENERATED

Buildkite Com Metrics Api Phrasing Overlay

2 actions · phrasing · buildkite-com-metrics-api-openapi.yml

GENERATED

Buildkite Com Organizations Api Phrasing Overlay

3 actions · phrasing · buildkite-com-organizations-api-openapi.yml

GENERATED

Buildkite Com Pipeline Templates Api Phrasing Overlay

2 actions · phrasing · buildkite-com-pipeline-templates-api-openapi.yml

GENERATED

Buildkite Com Pipelines Api Phrasing Overlay

6 actions · phrasing · buildkite-com-pipelines-api-openapi.yml

GENERATED

Buildkite Com Queues Api Phrasing Overlay

2 actions · phrasing · buildkite-com-queues-api-openapi.yml

GENERATED

Buildkite Com Rest Api Overlay

4 actions · documentation · buildkite-rest-api-openapi.yml

DERIVED

Buildkite Com Rules Api Phrasing Overlay

2 actions · phrasing · buildkite-com-rules-api-openapi.yml

GENERATED

Buildkite Com Stacks Api Phrasing Overlay

2 actions · phrasing · buildkite-com-stacks-api-openapi.yml

GENERATED

Buildkite Com Teams Api Phrasing Overlay

2 actions · phrasing · buildkite-com-teams-api-openapi.yml

GENERATED

Buildkite Com User Api Phrasing Overlay

2 actions · phrasing · buildkite-com-user-api-openapi.yml

GENERATED

Scroll for all 22

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Buildkite Agent

15 properties

JSON SCHEMA

Buildkite Build

20 properties

JSON SCHEMA

Buildkite Pipeline

20 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Buildkite Com Pipeline Structure

0 properties

JSON STRUCTURE

Examples 3

Example request and response payloads for these APIs.

Buildkite Create Build Example

2 fields

EXAMPLE

Buildkite Graphql Builds Example

2 fields

EXAMPLE

Buildkite List Agents Example

2 fields

EXAMPLE

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Buildkite Com Authentication

http/oauth2 · 3 schemes

SECURITY

Buildkite Com Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Buildkite Com Trust Center

SOC 2

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Buildkite Com Scopes

42 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Buildkite Com Agentic Access

32 operations · 9 acting · 2 human-in-the-loop

32 operations · 9 acting

AGENTIC

Integrations 19

Pre-built integrations with other platforms and tools.

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

Scroll for all 19

Resources

Get Started 4

Portal, sign-up, and the first successful call

Login

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 19

Pagination, idempotency, versioning, errors, and events

Spectral

Spectral

Webhooks

Lifecycle

Conventions

Conformance

ErrorCatalog

DataModel

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Vocabulary

Spectral

Scroll for all 19

Build 17

SDKs, sample code, and the tooling you integrate with

ToolCrosswalk

Packages

CLI

PostmanWorkspace

GitHubOrganization

SourceCode

CLI

SDKs

SDKs

Tools

Tools

Tools

Tools

Tools

Tools

Tools

SourceCode

Scroll for all 17

Access & Security 8

Authentication, authorization, and security posture

Compliance

TrustCenter

DomainSecurity

Authentication

OAuthScopes

SecurityPolicy

TrustCenter

Authentication

Scroll for all 8

Operate 8

Status, limits, changes, and where to get help

Deprecation

ChangeLog

StatusPage

ChangeLog

Forums

Support

RateLimits

RateLimits

Scroll for all 8

Commercial 5

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

FinOps

Company 3

The organization behind the API

Newsroom

Newsroom

Website

Website

Blog

Blog

Other 5

Properties that don't map to a standard resource type

Hosts

Vendors

Overlay

Overlay

CapabilityMap

Source (apis.yml)

aid: buildkite-com
deliveryModel:
  model: saas
  license_evidence:
    not_product:
    - buildkite/agent
    - buildkite/buildkite-mcp-server
    - buildkite/docs
  open_source: unknown
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: low
  source:
  - openapi
  - pricing
  - repository-not-product
  generated: '2026-09-25'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  - scopes
  - security
  generated: '2026-11-02'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/buildkite-com.png
url: https://raw.githubusercontent.com/api-evangelist/buildkite-com/refs/heads/main/apis.yml
name: Buildkite
tags:
- CI/CD
- Continuous Integration
- Continuous Delivery
- DevOps
- Pipelines
- Hybrid CI
- Build Automation
- Test Engine
- Package Registries
- Agents
- GraphQL
- REST
- MCP
- Webhook
- Australia
created: '2026-05-25T00:00:00.000Z'
modified: '2026-06-20'
position: Consuming
description: 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.
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.23'
common:
- type: Spectral
  url: rules/buildkite-com-rules.yml
- type: Spectral
  url: rules/buildkite-com-jsonschema-spectral-rules.yml
- type: Webhooks
  url: asyncapi/buildkite-com-webhooks.yml
- type: Compliance
  url: https://trust.buildkite.com/
- type: Deprecation
  url: lifecycle/buildkite-com-lifecycle.yml
- type: ToolCrosswalk
  url: mcp/buildkite-com-tool-crosswalk.yml
- type: Hosts
  url: hosts/buildkite-com-hosts.yml
- type: Vendors
  url: vendors/buildkite-com-vendors.yml
- type: Newsroom
  url: https://buildkite.com/about/press/
- type: Login
  url: https://buildkite.com/login
- type: Website
  url: https://www.buildkite.com/
- type: AgenticAccess
  url: agentic-access/buildkite-com-agentic-access.yml
- type: TrustCenter
  url: security/buildkite-com-trust-center.yml
- type: DomainSecurity
  url: security/buildkite-com-domain-security.yml
- type: Authentication
  url: authentication/buildkite-com-authentication.yml
- type: OAuthScopes
  url: scopes/buildkite-com-scopes.yml
- type: Packages
  url: packages/buildkite-com-packages.yml
- type: WellKnown
  url: well-known/buildkite-com-well-known.yml
- type: MCPServer
  url: mcp/buildkite-com-mcp.yml
- type: LLMsTxt
  url: llms/buildkite-com-llms.txt
- type: CLI
  url: cli/buildkite-com-cli.yml
- type: ChangeLog
  url: changelog/buildkite-com-changelog.yml
- type: Lifecycle
  url: lifecycle/buildkite-com-lifecycle.yml
- type: Conventions
  url: conventions/buildkite-com-conventions.yml
- type: Conformance
  url: conformance/buildkite-com-conformance.yml
- type: ErrorCatalog
  url: errors/buildkite-com-problem-types.yml
- type: DataModel
  url: data-model/buildkite-com-data-model.yml
- type: Overlay
  url: overlays/buildkite-com-rest-api-overlay.yaml
- type: Overlay
  url: overlays/buildkite-com-agent-api-overlay.yaml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/buildkite/overview
- type: Arazzo
  url: arazzo/buildkite-com-build-failure-triage-workflow.yml
  name: Buildkite Build Failure Triage
- type: Arazzo
  url: arazzo/buildkite-com-cancel-running-build-workflow.yml
  name: Buildkite Cancel Running Build
- type: Arazzo
  url: arazzo/buildkite-com-collect-build-artifacts-workflow.yml
  name: Buildkite Collect Build Artifacts
- type: Arazzo
  url: arazzo/buildkite-com-fetch-job-log-workflow.yml
  name: Buildkite Fetch Job Log
- type: Arazzo
  url: arazzo/buildkite-com-provision-pipeline-and-first-build-workflow.yml
  name: Buildkite Provision Pipeline And First Build
- type: Arazzo
  url: arazzo/buildkite-com-rebuild-latest-build-workflow.yml
  name: Buildkite Rebuild Latest Build
- type: Arazzo
  url: arazzo/buildkite-com-retry-failed-job-workflow.yml
  name: Buildkite Retry Failed Job
- type: Arazzo
  url: arazzo/buildkite-com-stop-disconnected-agent-workflow.yml
  name: Buildkite Stop Disconnected Agent
- type: Arazzo
  url: arazzo/buildkite-com-trigger-and-poll-build-workflow.yml
  name: Buildkite Trigger And Poll Build
- type: Portal
  url: https://buildkite.com
- type: Documentation
  url: https://buildkite.com/docs
- type: GettingStarted
  url: https://buildkite.com/docs/tutorials/getting-started
- type: Signup
  url: https://buildkite.com/signup
- type: Pricing
  url: https://buildkite.com/pricing
- type: TermsOfService
  url: https://buildkite.com/legal/terms-of-service
- type: PrivacyPolicy
  url: https://buildkite.com/legal/privacy-policy
- type: SecurityPolicy
  url: https://buildkite.com/security
- type: TrustCenter
  url: https://buildkite.com/security
- type: StatusPage
  url: https://buildkitestatus.com
- type: ChangeLog
  url: https://buildkite.com/changelog
- type: Blog
  url: https://buildkite.com/blog
- type: Forums
  url: https://forum.buildkite.community
- type: Support
  url: https://buildkite.com/support
- type: Authentication
  url: https://buildkite.com/docs/apis/managing-api-tokens
- type: RateLimits
  url: https://buildkite.com/docs/apis/rest-api#rate-limits
- url: https://github.com/buildkite
  type: GitHubOrganization
- url: https://github.com/buildkite/agent
  name: Buildkite Agent (Go)
  type: SourceCode
- url: https://github.com/buildkite/cli
  name: Buildkite CLI
  type: CLI
- url: https://github.com/buildkite/go-buildkite
  name: Go SDK
  type: SDKs
- url: https://github.com/buildkite/go-pipeline
  name: Go Pipeline DSL
  type: SDKs
- url: https://github.com/buildkite/pipeline-schema
  name: Pipeline JSON Schema
  type: JSONSchema
- url: https://github.com/buildkite/buildkite-mcp-server
  name: Buildkite MCP Server
  type: Tools
- url: https://github.com/buildkite/skills
  name: Buildkite AI Coding Skills
  type: Tools
- url: https://github.com/buildkite/agent-stack-k8s
  name: Agent Stack for Kubernetes
  type: Tools
- url: https://github.com/buildkite/elastic-ci-stack-for-aws
  name: Elastic CI Stack for AWS
  type: Tools
- url: https://github.com/buildkite/buildkite-agent-scaler
  name: Agent Auto-Scaler (Lambda)
  type: Tools
- url: https://github.com/buildkite/cleanroom
  name: Cleanroom microVM sandboxes
  type: Tools
- url: https://github.com/buildkite/emojis
  name: Buildkite Emoji set
  type: Tools
- url: https://github.com/buildkite/docs
  name: Buildkite Documentation Source
  type: SourceCode
- type: Integrations
  data:
  - 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
- type: Features
  data:
  - 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
  sources:
  - https://buildkite.com/docs
  - https://buildkite.com/docs/apis
  - https://buildkite.com/pricing
  - https://buildkite.com/changelog
  - https://github.com/buildkite
  updated: '2026-05-25'
- url: plans/buildkite-com-plans-pricing.yml
  type: Plans
- url: rate-limits/buildkite-com-rate-limits.yml
  type: RateLimits
- url: finops/buildkite-com-finops.yml
  type: FinOps
- url: vocabulary/buildkite-com-vocabulary.yml
  type: Vocabulary
- url: rules/buildkite-rules.yml
  type: Spectral
- type: CapabilityMap
  url: capabilities/buildkite-com-capability-edges.yml
  name: Buildkite Business Capability Map
apis:
- aid: buildkite-com:buildkite-graphql-api
  name: Buildkite GraphQL API
  tags:
  - CI/CD
  - GraphQL
  - Pipelines
  - Test Engine
  humanURL: https://buildkite.com/docs/apis/graphql-api
  baseURL: https://graphql.buildkite.com/v1
  properties:
  - url: https://buildkite.com/docs/apis/graphql-api
    type: Documentation
  - url: https://buildkite.com/docs/apis/graphql/graphql-cookbook
    type: Documentation
  - url: https://graphql.buildkite.com/explorer
    type: Sandbox
  - url: graphql/buildkite-com-graphql.md
    type: GraphQL
  description: GraphQL endpoint that returns deeply nested data on organizations, pipelines, builds, jobs, agents, clusters,
    queues, teams, audit events, suites, test executions, and package registries in a single request. Implements the Relay
    specification for pagination and supports schema introspection. Requires an API access token with "Enable GraphQL API
    Access" permission. GraphQL Portals allow scoped, schema-filtered access without per-token scopes.
- aid: buildkite-com:buildkite-agent-api
  name: Buildkite Agent API
  tags:
  - CI/CD
  - Agents
  - Hybrid CI
  humanURL: https://buildkite.com/docs/apis/agent-api
  baseURL: https://agent.buildkite.com/v3
  properties:
  - url: https://buildkite.com/docs/apis/agent-api
    type: Documentation
  - url: https://buildkite.com/docs/agent/v3
    type: Documentation
  - url: https://github.com/buildkite/agent
    type: SourceCode
  description: 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 autoscaling. Authenticated via Agent Tokens issued per
    cluster. Public surface includes `/metrics` (for autoscaling) and `/stacks` (for self-hosted queue controllers). The `agent-edge.buildkite.com`
    host adds gRPC methods. Most other endpoints are reserved for internal agent use.
- aid: buildkite-com:buildkite-webhooks
  name: Buildkite Webhooks
  tags:
  - CI/CD
  - Webhook
  - Event
  - Notification
  tags_raw:
  - CI/CD
  - Webhooks
  - Events
  - Notifications
  humanURL: https://buildkite.com/docs/apis/webhooks
  properties:
  - url: https://buildkite.com/docs/apis/webhooks
    type: Documentation
  - url: https://buildkite.com/docs/pipelines/integrations/notifications
    type: Documentation
  description: 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 `X-Buildkite-Token` header. Configured per organization
    via Notification Services. Supports an expanded set of GitHub-style triggers including pull request reviews, releases,
    issue comments, and deployment status events.
- aid: buildkite-com:buildkite-mcp-server
  name: Buildkite MCP Server
  tags:
  - CI/CD
  - MCP
  - Artificial Intelligence
  - Agents
  tags_raw:
  - CI/CD
  - MCP
  - Model Context Protocol
  - AI
  - Agents
  humanURL: https://github.com/buildkite/buildkite-mcp-server
  properties:
  - url: https://github.com/buildkite/buildkite-mcp-server
    type: Documentation
  - url: https://github.com/buildkite/buildkite-mcp-server
    type: SourceCode
  - url: mcp/buildkite-com-mcp.yml
    type: MCPServer
  description: 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 agents. Available as both a remote endpoint and a local
    binary. Pairs with the official Buildkite Skills for Claude Code and Cursor.
- aid: buildkite-com:buildkite-com-access-token-api
  name: Buildkite Access Token API
  description: The Access Token API from Buildkite — 1 operation(s) for access token.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Access Token
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-access-token-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-agent-tokens-api
  name: Buildkite Agent Tokens API
  description: The Agent Tokens API from Buildkite — 1 operation(s) for agent tokens.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Agent Tokens
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-agent-tokens-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-agents-api
  name: Buildkite Agents API
  description: The Agents API from Buildkite — 3 operation(s) for agents.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Agents
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-agents-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-annotations-api
  name: Buildkite Annotations API
  description: The Annotations API from Buildkite — 1 operation(s) for annotations.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Annotation
  tags_raw:
  - Annotations
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-annotations-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-artifacts-api
  name: Buildkite Artifacts API
  description: The Artifacts API from Buildkite — 1 operation(s) for artifacts.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Artifacts
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-artifacts-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-builds-api
  name: Buildkite Builds API
  description: The Builds API from Buildkite — 4 operation(s) for builds.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Builds
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-builds-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-clusters-api
  name: Buildkite Clusters API
  description: The Clusters API from Buildkite — 1 operation(s) for clusters.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Cluster
  tags_raw:
  - Clusters
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-clusters-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-emojis-api
  name: Buildkite Emojis API
  description: The Emojis API from Buildkite — 1 operation(s) for emojis.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Emojis
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-emojis-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-jobs-api
  name: Buildkite Jobs API
  description: The Jobs API from Buildkite — 2 operation(s) for jobs.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Job
  tags_raw:
  - Jobs
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-jobs-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-meta-api
  name: Buildkite Meta API
  description: The Meta API from Buildkite — 1 operation(s) for meta.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Meta
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-meta-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-metrics-api
  name: Buildkite Metrics API
  description: The Metrics API from Buildkite — 1 operation(s) for metrics.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Metrics
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-metrics-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-organizations-api
  name: Buildkite Organizations API
  description: The Organizations API from Buildkite — 2 operation(s) for organizations.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Organization
  tags_raw:
  - Organizations
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-organizations-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-pipeline-templates-api
  name: Buildkite Pipeline Templates API
  description: The Pipeline Templates API from Buildkite — 1 operation(s) for pipeline templates.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Pipeline Templates
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-pipeline-templates-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-pipelines-api
  name: Buildkite Pipelines API
  description: The Pipelines API from Buildkite — 2 operation(s) for pipelines.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Pipelines
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-pipelines-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-queues-api
  name: Buildkite Queues API
  description: The Queues API from Buildkite — 1 operation(s) for queues.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Queues
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-queues-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-rules-api
  name: Buildkite Rules API
  description: The Rules API from Buildkite — 1 operation(s) for rules.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Rules
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-rules-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-stacks-api
  name: Buildkite Stacks API
  description: The Stacks API from Buildkite — 1 operation(s) for stacks.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Stacks
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-stacks-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-teams-api
  name: Buildkite Teams API
  description: The Teams API from Buildkite — 1 operation(s) for teams.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - Team
  tags_raw:
  - Teams
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-teams-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
- aid: buildkite-com:buildkite-com-user-api
  name: Buildkite User API
  description: The User API from Buildkite — 1 operation(s) for user.
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  tags:
  - User
  properties:
  - type: OpenAPI
    url: openapi/buildkite-com-user-api-openapi.yml
  - type: Documentation
    url: https://buildkite.com/docs/apis/rest-api
  - type: Authentication
    url: https://buildkite.com/docs/apis/managing-api-tokens
  - type: JSONSchema
    url: json-schema/buildkite-pipeline-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-build-schema.json
  - type: JSONSchema
    url: json-schema/buildkite-agent-schema.json
  - type: JSONLD
    url: json-ld/buildkite-com-context.jsonld
tags_raw:
- CI/CD
- Continuous Integration
- Continuous Delivery
- DevOps
- Pipelines
- Hybrid CI
- Build Automation
- Test Engine
- Package Registries
- Agents
- GraphQL
- REST
- MCP
- Webhooks
- Australia
x-enrichment:
  date: '2026-10-04'
  status: enriched
  artifacts_added: 7
  pass: modular-v1
  engine: identity=local,contract=local,surfaces=local,docs=local,regulatory=local

Buildkite API — frequently asked questions

Does Buildkite have an API?

Yes. APIs.io lists 23 APIs from Buildkite, including Buildkite GraphQL API, Buildkite Agent API and Buildkite Webhooks, and 20 more.

Is there an OpenAPI specification for the Buildkite API?

Yes. APIs.io indexes 19 OpenAPI specifications for Buildkite, each linked for download from this page.

How do I authenticate with the Buildkite API?

Buildkite documents its authentication (http/oauth2 · 3 schemes). The details are profiled on APIs.io as Buildkite Com Authentication.

How much does the Buildkite API cost?

APIs.io lists 5 pricing plans for Buildkite, with each plan's price, limits and inclusions under Pricing Plans on this page.

Does Buildkite have an MCP server?

Yes. APIs.io lists 1 MCP server for Buildkite: Buildkite operates an official Model Context Protocol server that exposes the REST API (organizations, clusters, agents, pipelines, builds, jobs, artifacts, annotations, logs, Test Engine) as MCP tool

Is the Buildkite API ready for AI agents?

Buildkite has a Kin Score of 72.8 out of 100 (exemplar) and an Agent Readiness score of 50.6 (agent-ready), scored by API Evangelist on 2026-11-02.

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/buildkite-com"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/buildkite-com/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/buildkite-com/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.