From 1b6a65441a16d6886255e442530831537868beaa Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 2 Oct 2026 16:56:30 +0000
Subject: [PATCH] docs: add changelog entry for Dynamic CI Buildkite API token

---
 ...26-10-02-dynamic-ci-buildkite-api-token.mdx | 18 ++++++++++++++++++
 changelog/index.mdx                            |  8 ++++++++
 docs.json                                      |  6 ++++++
 3 files changed, 32 insertions(+)
 create mode 100644 changelog/2026-10-02-dynamic-ci-buildkite-api-token.mdx

diff --git a/changelog/2026-10-02-dynamic-ci-buildkite-api-token.mdx b/changelog/2026-10-02-dynamic-ci-buildkite-api-token.mdx
new file mode 100644
index 00000000..287813af
--- /dev/null
+++ b/changelog/2026-10-02-dynamic-ci-buildkite-api-token.mdx
@@ -0,0 +1,18 @@
+---
+title: "Dynamic CI: Buildkite API token connection"
+description: "Connect a Buildkite API token so Trunk can see the Buildkite steps Dynamic CI skips."
+slug: dynamic-ci-buildkite-api-token
+date: 2026-10-02
+category: Dynamic CI
+type: update
+---
+
+**You can now connect a Buildkite API token to Dynamic CI.**
+
+Buildkite sends no telemetry for a job that never runs. Without a token, Trunk can't see the steps [Dynamic CI](/ci/dynamic-ci) skipped.
+
+- **Connect in Settings.** Paste a Buildkite API token into [Settings → Organization → Buildkite](https://app.trunk.io/settings/organization/buildkite).
+- **Two scopes.** The token needs `read_builds` and `read_organizations`.
+- **Use a dedicated user.** Create the token from a dedicated Buildkite user rather than a personal account.
+
+See [Dynamic CI for Buildkite](/ci/dynamic-ci/getting-started/buildkite) for the full setup.
diff --git a/changelog/index.mdx b/changelog/index.mdx
index b61b1290..fd7d6dda 100644
--- a/changelog/index.mdx
+++ b/changelog/index.mdx
@@ -6,6 +6,14 @@ rss: true
 
 ## 2026
 
+### October 2026
+
+<Update label="October 2, 2026" tags={["Dynamic CI"]}>
+  **[Dynamic CI: Buildkite API token connection](/changelog/2026-10-02-dynamic-ci-buildkite-api-token)**
+
+  Connect a Buildkite API token so Trunk can see the Buildkite steps Dynamic CI skips.
+</Update>
+
 ### September 2026
 
 <Update label="September 30, 2026" tags={["Flaky Tests"]}>
diff --git a/docs.json b/docs.json
index 0db2d6d3..8783d626 100644
--- a/docs.json
+++ b/docs.json
@@ -922,6 +922,12 @@
           {
             "group": "2026",
             "pages": [
+              {
+                "group": "October",
+                "pages": [
+                  "changelog/2026-10-02-dynamic-ci-buildkite-api-token"
+                ]
+              },
               {
                 "group": "September",
                 "pages": [