Buildkite

aid: buildkite-com
url: https://raw.githubusercontent.com/api-evangelist/buildkite-com/refs/heads/main/apis.yml
apis:
- aid: buildkite-com:buildkite-rest-api
  name: Buildkite REST API
  tags:
  - CI/CD
  - Continuous Integration
  - Continuous Delivery
  - Pipelines
  - Builds
  - Agents
  humanURL: https://buildkite.com/docs/apis/rest-api
  baseURL: https://api.buildkite.com/v2
  properties:
  - url: https://buildkite.com/docs/apis/rest-api
    type: Documentation
  - url: https://buildkite.com/docs/apis/managing-api-tokens
    type: Authentication
  - url: openapi/buildkite-rest-api-openapi.yml
    type: OpenAPI
  - 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: JSONSchema
  - url: json-ld/buildkite-com-context.jsonld
    type: JSONLD
  description: >-
    Programmatic access to Buildkite Pipelines covering organizations, pipelines, builds, jobs, artifacts,
    annotations, agents, clusters, queues, agent tokens, teams, pipeline templates, rules, and emojis. Uses Bearer
    token authentication with scoped API access tokens. Designed to extend, integrate, and automate CI/CD workflows
    across hybrid infrastructure.
- 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
  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.
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/buildkite/overview
- type: ArazzoWorkflows
  url: arazzo/
  workflows:
  - url: arazzo/buildkite-com-build-failure-triage-workflow.yml
    name: Buildkite Build Failure Triage
    summary: Inspect a finished build, then pull its annotations and artifacts for triage.
  - url: arazzo/buildkite-com-cancel-running-build-workflow.yml
    name: Buildkite Cancel Running Build
    summary: Find the latest running build on a pipeline and cancel it.
  - url: arazzo/buildkite-com-collect-build-artifacts-workflow.yml
    name: Buildkite Collect Build Artifacts
    summary: Look up a build, confirm it finished, then list its artifacts.
  - url: arazzo/buildkite-com-fetch-job-log-workflow.yml
    name: Buildkite Fetch Job Log
    summary: Read a build, pick a finished job, and fetch its log output.
  - url: arazzo/buildkite-com-provision-pipeline-and-first-build-workflow.yml
    name: Buildkite Provision Pipeline And First Build
    summary: Create a pipeline in an organization, then trigger its first build.
  - url: arazzo/buildkite-com-rebuild-latest-build-workflow.yml
    name: Buildkite Rebuild Latest Build
    summary: Find the most recent build on a pipeline, rebuild it, then poll the new build.
  - url: arazzo/buildkite-com-retry-failed-job-workflow.yml
    name: Buildkite Retry Failed Job
    summary: Find a failed job in a build, retry it, then poll the build to completion.
  - url: arazzo/buildkite-com-stop-disconnected-agent-workflow.yml
    name: Buildkite Stop Disconnected Agent
    summary: List agents, inspect one, and stop it when it is no longer connected.
  - url: arazzo/buildkite-com-trigger-and-poll-build-workflow.yml
    name: Buildkite Trigger And Poll Build
    summary: Create a build on a pipeline, then poll until it reaches a terminal state.
- 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: Forum
  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: SDK
- url: https://github.com/buildkite/go-pipeline
  name: Go Pipeline DSL
  type: SDK
- 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: Tool
- url: https://github.com/buildkite/skills
  name: Buildkite AI Coding Skills
  type: Tool
- url: https://github.com/buildkite/agent-stack-k8s
  name: Agent Stack for Kubernetes
  type: Tool
- url: https://github.com/buildkite/elastic-ci-stack-for-aws
  name: Elastic CI Stack for AWS
  type: Tool
- url: https://github.com/buildkite/buildkite-agent-scaler
  name: Agent Auto-Scaler (Lambda)
  type: Tool
- url: https://github.com/buildkite/cleanroom
  name: Cleanroom microVM sandboxes
  type: Tool
- url: https://github.com/buildkite/emojis
  name: Buildkite Emoji set
  type: Tool
- 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-05-25'
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'