aid: buildkite
url: https://raw.githubusercontent.com/api-evangelist/buildkite/refs/heads/main/apis.yml
name: Buildkite
x-type: company
description: >-
  Buildkite is a CI/CD platform with self-hosted agents and a hosted control
  plane. The platform exposes a REST API, a GraphQL API and an Agent API used
  by buildkite-agent. Resources include organizations, pipelines, pipeline
  templates, builds, jobs, agents, clusters, queues, teams, rules, artifacts,
  annotations, and access tokens. Test Engine adds test execution and analytics
  endpoints.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
  - DevOps
  - CI/CD
  - Pipelines
  - Agents
  - Self-Hosted
  - GraphQL
  - Test Engine
created: '2026-05-08'
modified: '2026-05-08'
specificationVersion: '0.19'
apis:
  - aid: buildkite:rest
    name: Buildkite REST API
    description: >-
      JSON over HTTPS REST API for the Buildkite control plane. Bearer-token
      auth with API access tokens.
    image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://buildkite.com/docs/apis/rest-api
    baseURL: https://api.buildkite.com/v2
    tags:
      - REST
      - Pipelines
      - Builds
      - Agents
      - Clusters
    properties:
      - type: Documentation
        url: https://buildkite.com/docs/apis/rest-api
      - type: Authentication
        url: https://buildkite.com/docs/apis/managing-api-tokens
  - aid: buildkite:graphql
    name: Buildkite GraphQL API
    description: >-
      Relay-compliant GraphQL API. Single endpoint for nested queries across
      organizations, pipelines, builds, jobs, agents, teams. Introspection
      supported. Bearer auth with the "Enable GraphQL API Access" scope.
    image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://buildkite.com/docs/apis/graphql-api
    baseURL: https://graphql.buildkite.com/v1
    tags:
      - GraphQL
      - Relay
    properties:
      - type: Documentation
        url: https://buildkite.com/docs/apis/graphql-api
      - type: Console
        url: https://buildkite.com/user/graphql/console
  - aid: buildkite:agent-api
    name: Buildkite Agent API
    description: >-
      API consumed by buildkite-agent — register, retrieve work, send job
      events and upload artifacts/annotations. Used by self-hosted and hosted
      agents.
    image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://buildkite.com/docs/apis/agent-api
    baseURL: https://agent.buildkite.com/v3
    tags:
      - REST
      - Agent
      - Internal
    properties:
      - type: Documentation
        url: https://buildkite.com/docs/apis/agent-api
common:
  - type: Website
    url: https://buildkite.com/
  - type: Documentation
    url: https://buildkite.com/docs
  - type: Pricing
    url: https://buildkite.com/pricing
  - type: GitHub
    url: https://github.com/buildkite
  - type: StatusPage
    url: https://buildkitestatus.com/
  - type: Plans
    url: plans/buildkite-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/buildkite-rate-limits.yml
  - type: FinOps
    url: finops/buildkite-finops.yml
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com