Home
Providers
Buildkite
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 19 APIs on the APIs.io network, including Access Token API, Agent Tokens API, Agents API, and 16 more. 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.
23 APIs
1 MCP Servers
23 Features
CI/CD Continuous Integration Continuous Delivery DevOps Pipelines Hybrid CI Build Automation Test Engine Package Registries Agents GraphQL REST MCP Webhooks
On this page
Kin Score
APIs 23
Postman 1
Open Collections 2
Arazzo 9
MCP Servers 1
GraphQL 1
Pricing Plans 1
Rate Limits 1
FinOps 1
Features 23
Vocabularies 1
Spectral Rules 2
JSON Schema 3
JSON Structure 1
Examples 3
Security Posture 3
Scopes 1
Agentic Access 1
Integrations 19
Resources 63
apis.yml
47 Operational Transparency
Composite quality — 71.1/100 · exemplar
Contract Quality
16.9 / 25
Developer Ergonomics
14.3 / 20
Commercial Clarity
15.8 / 20
Operational Transparency
6.2 / 13
Agent readiness — 49/100 · agent ready
Machine-Readable Contract
18 / 18
Agentic Access Contract
10 / 10
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
A2A Agent Card
0 / 8
Dry-Run / Simulate Mode
0 / 4
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 23
Ready-to-run Postman collections for exercising this provider's APIs.
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Multi-step API workflows described with the Arazzo specification.
Scroll for all 9
Model Context Protocol servers that expose these APIs to AI agents.
GraphQL schemas published by this provider.
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
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
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
JSON Structure definitions describing this provider's data shapes.
Example request and response payloads for these APIs.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
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
Get Started 3
Portal, sign-up, and the first successful call
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 4
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 16
Pagination, idempotency, versioning, errors, and events
Scroll for all 16
Build 16
SDKs, sample code, and the tooling you integrate with
Scroll for all 16
Access & Security 7
Authentication, authorization, and security posture
Scroll for all 7
Operate 7
Status, limits, changes, and where to get help
Scroll for all 7
Commercial 5
Pricing, plans, and the legal terms of use
Company 1
The organization behind the API
Other 2
Properties that don't map to a standard resource type
Source (apis.yml)
aid: buildkite-com
accessModel:
pricing: paid
onboarding: self-serve
trial: false
try_now: false
public: false
label: Paid · Self-serve signup
confidence: high
source:
- plans
- authentication
generated: '2026-07-22'
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
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
- 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
- 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:
- 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:
- 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:
- 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:
- 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:
- 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
common:
- 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
name: Buildkite
tags:
- CI/CD
- Continuous Integration
- Continuous Delivery
- DevOps
- Pipelines
- Hybrid CI
- Build Automation
- Test Engine
- Package Registries
- Agents
- GraphQL
- REST
- MCP
- Webhooks
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.16'