# Buildkite integration

> Buildkite REST API v2 for CI/CD — manage pipelines, trigger and inspect builds, control agents, read artifacts and logs, and query Test Engine analytics.

- Authentication: apiKey

## Tools (139)

- **Add a Webhook to a Pipeline**: Create a GitHub webhook for an existing pipeline.
- **Archive a Pipeline**: Archive a pipeline, making it read-only and hidden.
- **Cancel a Build**: Cancel a running or scheduled build.
- **Configure Build Export**: Configure build export for the organization.
- **Create a Build**: Trigger a new build on a pipeline.
- **Create a Cluster**: Create a new cluster.
- **Create a Cluster Agent Token**: Create a new agent token for a cluster.
- **Create a Cluster Queue**: Create a self-hosted or Buildkite-hosted queue.
- **Create an Agent Image**: Create a custom hosted-agent image.
- **Create an Annotation**: Create an annotation on a build.
- **Create a Notification Service**: Create a notification service (webhook or integration).
- **Create a Pipeline**: Create a new pipeline (YAML configuration or visual steps).
- **Create a Pipeline Template**: Create a pipeline template.
- **Create a Portal**: Create a portal.
- **Create a Rule**: Create a cross-pipeline rule.
- **Create a Team**: Create a new team.
- **Create a Team Member**: Add a user to a team.
- **Create a Team Pipeline**: Associate a pipeline with a team.
- **Create a Team Suite**: Associate a test suite with a team.
- **Create a Test Suite**: Create a new Test Engine suite.
- **Delete a Cache Volume**: Delete cache volume data by tag.
- **Delete a Cluster**: Delete a cluster.
- **Delete a Cluster Queue**: Delete a queue.
- **Delete a Job's Log Output**: Delete a job's log output.
- **Delete an Agent Image**: Delete a custom hosted-agent image.
- **Delete an Annotation**: Delete an annotation from a build.
- **Delete an Artifact**: Delete an artifact.
- **Delete a Notification Service**: Delete a notification service.
- **Delete a Pipeline**: Permanently delete a pipeline.
- **Delete a Pipeline Template**: Delete a pipeline template.
- **Delete a Portal**: Delete a portal.
- **Delete a Rule**: Delete a rule.
- **Delete a Team**: Delete a team.
- **Delete a Team Member**: Remove a user from a team.
- **Delete a Team Pipeline**: Remove a pipeline from a team.
- **Delete a Team Suite**: Remove a test suite from a team.
- **Delete a Test Suite**: Delete a Test Engine suite.
- **Disable a Notification Service**: Disable a notification service.
- **Disable Build Export**: Disable build export.
- **Disable Hosted Agents Terminal Access**: Disable SSH terminal access on hosted agents.
- **Disable Public Pipeline Creation**: Disallow public pipeline creation.
- **Download an Artifact**: Get a temporary download URL for an artifact.
- **Enable Advanced Queue Metrics**: Enable advanced queue metrics.
- **Enable a Notification Service**: Enable a notification service.
- **Enable Hosted Agents Terminal Access**: Enable SSH terminal access on hosted agents.
- **Enable Public Pipeline Creation**: Allow members to create public pipelines.
- **Find a Test**: Look up a test's UUID by scope and name.
- **Get a Build**: Retrieve a single build by number.
- **Get a Cluster**: Retrieve a single cluster.
- **Get a Cluster Agent Token**: Retrieve a single agent token.
- **Get a Cluster Queue**: Retrieve a single queue.
- **Get a Job's Environment Variables**: Retrieve the environment variables of a job.
- **Get a Job's Log Output**: Retrieve a job's log output.
- **Get an Agent**: Retrieve a single agent.
- **Get an Agent Image**: Retrieve a single hosted-agent image.
- **Get an Artifact**: Retrieve an artifact's metadata.
- **Get an Audit Event**: Retrieve a single audit event.
- **Get an Organization**: Retrieve a single organization by slug.
- **Get an Organization Member**: Retrieve a single organization member.
- **Get a Notification Service**: Retrieve a single notification service.
- **Get a Pipeline**: Retrieve a single pipeline by slug.
- **Get a Pipeline Template**: Retrieve a single pipeline template.
- **Get a Portal**: Retrieve a single portal.
- **Get a Repository Connection**: Retrieve a single repository connection.
- **Get a Rule**: Retrieve a single rule.
- **Get a Team**: Retrieve a single team.
- **Get a Team Member**: Retrieve a single team membership.
- **Get a Team Pipeline**: Retrieve a single team-pipeline association.
- **Get a Team Suite**: Retrieve a single team-suite association.
- **Get a Test**: Retrieve a single test.
- **Get a Test Run**: Retrieve a single test run.
- **Get a Test Run's Failed Executions**: List the failed test executions in a run.
- **Get a Test Suite**: Retrieve a single Test Engine suite.
- **Get Current Access Token**: Introspect the current access token (uuid and scopes).
- **Get Current User**: Retrieve the user account that owns the token.
- **Get Meta Information**: Get Buildkite metadata such as webhook source IPs.
- **Get Organization API Settings**: Get the organization's API access settings.
- **Get Organization Pipeline Settings**: Get the organization's default pipeline settings.
- **Get Organization Rate Limits**: Get the organization's current REST and GraphQL API rate-limit status.
- **List Agent Images**: List a cluster's custom hosted-agent images.
- **List Agents**: List an organization's connected agents.
- **List All Builds**: List builds across all organizations and pipelines the token can access.
- **List Annotations for a Build**: List a build's annotations.
- **List Artifacts for a Build**: List all artifacts across a build's jobs.
- **List Artifacts for a Job**: List a single job's artifacts.
- **List Audit Events**: List the organization's audit events.
- **List Builds for an Organization**: List all builds in an organization.
- **List Builds for a Pipeline**: List all builds for a single pipeline.
- **List Cache Volumes**: List a cluster's hosted-agent cache volumes.
- **List Cluster Agent Tokens**: List a cluster's agent tokens.
- **List Cluster Queues**: List a cluster's queues.
- **List Clusters**: List an organization's clusters.
- **List Emojis**: List an organization's custom emojis.
- **List Network Ranges**: List a cluster's hosted-agent egress network ranges.
- **List Notification Services**: List the organization's notification services.
- **List Organization Members**: List an organization's members.
- **List Organizations**: List all organizations the token can access.
- **List Pipelines**: List an organization's pipelines.
- **List Pipeline Templates**: List the organization's pipeline templates.
- **List Portals**: List the organization's portals.
- **List Repository Connections**: List the organization's repository connections.
- **List Rules**: List the organization's rules.
- **List Team Members**: List members of a team.
- **List Team Pipelines**: List pipelines associated with a team.
- **List Teams**: List an organization's teams.
- **List Team Suites**: List test suites associated with a team.
- **List Test Runs**: List runs in a test suite.
- **List Tests**: List tests in a suite.
- **List Test Suites**: List an organization's Test Engine suites.
- **Pause a Cluster Queue's Dispatch**: Pause job dispatch for a queue.
- **Pause an Agent**: Pause an agent so it stops accepting new jobs.
- **Rebuild a Build**: Create a new build by re-running an existing one.
- **Remove an Organization Member**: Remove a member from an organization.
- **Reprioritize a Job**: Change the scheduling priority of a job.
- **Resume a Cluster Queue's Dispatch**: Resume job dispatch for a paused queue.
- **Resume an Agent**: Resume a paused agent.
- **Retry a Job**: Retry a single failed or manual job.
- **Retry Failed Jobs in a Build**: Retry the failed jobs within a build.
- **Revoke a Cluster Agent Token**: Revoke an agent token.
- **Revoke Current Access Token**: Revoke the access token making the request.
- **Stop an Agent**: Instruct an agent to stop.
- **Unarchive a Pipeline**: Restore an archived pipeline to editable state.
- **Unblock a Job**: Unblock a block-step job to continue the build.
- **Update a Cluster**: Update a cluster's settings.
- **Update a Cluster Agent Token**: Update an agent token's settings.
- **Update a Cluster Queue**: Update a queue's settings.
- **Update an Organization Member**: Update a member's role or SSO mode.
- **Update a Notification Service**: Update a notification service.
- **Update a Pipeline**: Update an existing pipeline's settings.
- **Update a Pipeline Template**: Update a pipeline template.
- **Update a Portal**: Update a portal.
- **Update a Team**: Update a team's settings.
- **Update a Team Member**: Change a team member's role.
- **Update a Team Pipeline**: Change a team-pipeline access level.
- **Update a Team Suite**: Change a team-suite access level.
- **Update a Test Suite**: Update a Test Engine suite.
- **Update Organization API Settings**: Update the organization's API access settings.
- **Update Organization Pipeline Settings**: Update the organization's default pipeline settings.
- **Update Test Labels**: Add or remove labels on a test.

## Triggers (2)

- **Build Finished in Buildkite**: Triggers when a build finishes (passed, failed, or canceled) in a Buildkite organization or pipeline.
- **Build Failed in Buildkite**: Triggers only when a build fails in a Buildkite organization or pipeline.

## Related prompts

- [AI triage for failed Buildkite builds, posted to Slack](https://www.generalinput.com/prompts/ai-triage-for-failed-buildkite-builds-posted-to-slack.md)
- [Turn Buildkite build failures into tracked Jira bugs](https://www.generalinput.com/prompts/turn-buildkite-build-failures-into-tracked-jira-bugs.md)
- [Weekly Buildkite CI health email for engineering leads](https://www.generalinput.com/prompts/weekly-buildkite-ci-health-email-for-engineering-leads.md)
- [Page on-call when a production deploy fails in Buildkite](https://www.generalinput.com/prompts/page-on-call-when-a-production-deploy-fails-in-buildkite.md)

Connect Buildkite in General Input: https://www.generalinput.com/apps/buildkite