#  Buildkite

Connect Buildkite to give Herald’s SRE agent access to your CI/CD pipeline data. During incident investigations, the agent can surface build failures and pipeline status to help diagnose deployment-related issues.

**The agent can:**

- List pipelines in your Buildkite organization
- Retrieve build and job details

| Parameter              | Description                                                                                                                                         |
|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| **API Token**         | A Buildkite API access token with `read_builds` and `read_pipelines` scopes. Create one under **Personal Settings > API Access Tokens** in Buildkite. |
| **Organization Slug** | Your Buildkite organization slug. This appears in your Buildkite URLs: `buildkite.com/my-org` → enter `my-org`.                                   |

**Optional parameters**

| Parameter                    | Description                                                                              |
|-----------------------------|------------------------------------------------------------------------------------------|
| **Rules / Instructions**     | Free-form instructions that guide the agent on how to use this integration.             |