diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetEvent.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetEvent.kt
index c0b4a52f..61e490f4 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetEvent.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetEvent.kt
@@ -82,7 +82,7 @@ private constructor(
 
     /**
      * A unique identifier used to link different dataset events together as part of a full trace.
-     * See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full details on
+     * See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full details on
      * tracing
      */
     fun spanId(): String = spanId.getRequired("span_id")
@@ -135,7 +135,7 @@ private constructor(
 
     /**
      * A unique identifier used to link different dataset events together as part of a full trace.
-     * See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full details on
+     * See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full details on
      * tracing
      */
     @JsonProperty("span_id") @ExcludeMissing fun _spanId() = spanId
@@ -342,14 +342,14 @@ private constructor(
 
         /**
          * A unique identifier used to link different dataset events together as part of a full
-         * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
+         * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full
          * details on tracing
          */
         fun spanId(spanId: String) = spanId(JsonField.of(spanId))
 
         /**
          * A unique identifier used to link different dataset events together as part of a full
-         * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
+         * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full
          * details on tracing
          */
         @JsonProperty("span_id")
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetFetchPostParams.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetFetchPostParams.kt
index 51faeb06..d3fdf52f 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetFetchPostParams.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/DatasetFetchPostParams.kt
@@ -90,7 +90,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
@@ -227,7 +227,7 @@ constructor(
 
             /**
              * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-             * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+             * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
              * advanced filtering.
              *
              * A list of filters on the events to fetch. Currently, only path-lookup type filters
@@ -409,7 +409,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
@@ -422,7 +422,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentEvent.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentEvent.kt
index 797e1b33..cde5ede3 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentEvent.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentEvent.kt
@@ -145,8 +145,8 @@ private constructor(
 
     /**
      * A unique identifier used to link different experiment events together as part of a full
-     * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
-     * details on tracing
+     * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full details
+     * on tracing
      */
     fun spanId(): String = spanId.getRequired("span_id")
 
@@ -259,8 +259,8 @@ private constructor(
 
     /**
      * A unique identifier used to link different experiment events together as part of a full
-     * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
-     * details on tracing
+     * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full details
+     * on tracing
      */
     @JsonProperty("span_id") @ExcludeMissing fun _spanId() = spanId
 
@@ -613,14 +613,14 @@ private constructor(
 
         /**
          * A unique identifier used to link different experiment events together as part of a full
-         * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
+         * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full
          * details on tracing
          */
         fun spanId(spanId: String) = spanId(JsonField.of(spanId))
 
         /**
          * A unique identifier used to link different experiment events together as part of a full
-         * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
+         * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full
          * details on tracing
          */
         @JsonProperty("span_id")
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentFetchPostParams.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentFetchPostParams.kt
index ea8c04bf..983f9590 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentFetchPostParams.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ExperimentFetchPostParams.kt
@@ -90,7 +90,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
@@ -227,7 +227,7 @@ constructor(
 
             /**
              * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-             * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+             * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
              * advanced filtering.
              *
              * A list of filters on the events to fetch. Currently, only path-lookup type filters
@@ -409,7 +409,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
@@ -422,7 +422,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertDatasetEventReplace.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertDatasetEventReplace.kt
index 6e21cffe..0dcec345 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertDatasetEventReplace.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertDatasetEventReplace.kt
@@ -87,7 +87,7 @@ private constructor(
     /**
      * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot be
      * specified alongside `_is_merge=true`. Tracking hierarchical relationships are important for
-     * tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing) for full details).
+     * tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for full details).
      *
      * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
      * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the parent
@@ -150,7 +150,7 @@ private constructor(
     /**
      * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot be
      * specified alongside `_is_merge=true`. Tracking hierarchical relationships are important for
-     * tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing) for full details).
+     * tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for full details).
      *
      * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
      * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the parent
@@ -365,8 +365,8 @@ private constructor(
         /**
          * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot
          * be specified alongside `_is_merge=true`. Tracking hierarchical relationships are
-         * important for tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing)
-         * for full details).
+         * important for tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for
+         * full details).
          *
          * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
          * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the
@@ -380,8 +380,8 @@ private constructor(
         /**
          * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot
          * be specified alongside `_is_merge=true`. Tracking hierarchical relationships are
-         * important for tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing)
-         * for full details).
+         * important for tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for
+         * full details).
          *
          * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
          * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertExperimentEventReplace.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertExperimentEventReplace.kt
index 00fb6d90..80cc4f6d 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertExperimentEventReplace.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertExperimentEventReplace.kt
@@ -152,7 +152,7 @@ private constructor(
     /**
      * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot be
      * specified alongside `_is_merge=true`. Tracking hierarchical relationships are important for
-     * tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing) for full details).
+     * tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for full details).
      *
      * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
      * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the parent
@@ -270,7 +270,7 @@ private constructor(
     /**
      * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot be
      * specified alongside `_is_merge=true`. Tracking hierarchical relationships are important for
-     * tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing) for full details).
+     * tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for full details).
      *
      * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
      * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the parent
@@ -627,8 +627,8 @@ private constructor(
         /**
          * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot
          * be specified alongside `_is_merge=true`. Tracking hierarchical relationships are
-         * important for tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing)
-         * for full details).
+         * important for tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for
+         * full details).
          *
          * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
          * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the
@@ -642,8 +642,8 @@ private constructor(
         /**
          * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot
          * be specified alongside `_is_merge=true`. Tracking hierarchical relationships are
-         * important for tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing)
-         * for full details).
+         * important for tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for
+         * full details).
          *
          * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
          * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertProjectLogsEventReplace.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertProjectLogsEventReplace.kt
index 139f1175..6e6a9a62 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertProjectLogsEventReplace.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/InsertProjectLogsEventReplace.kt
@@ -140,7 +140,7 @@ private constructor(
     /**
      * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot be
      * specified alongside `_is_merge=true`. Tracking hierarchical relationships are important for
-     * tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing) for full details).
+     * tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for full details).
      *
      * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
      * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the parent
@@ -247,7 +247,7 @@ private constructor(
     /**
      * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot be
      * specified alongside `_is_merge=true`. Tracking hierarchical relationships are important for
-     * tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing) for full details).
+     * tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for full details).
      *
      * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
      * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the parent
@@ -579,8 +579,8 @@ private constructor(
         /**
          * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot
          * be specified alongside `_is_merge=true`. Tracking hierarchical relationships are
-         * important for tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing)
-         * for full details).
+         * important for tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for
+         * full details).
          *
          * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
          * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the
@@ -594,8 +594,8 @@ private constructor(
         /**
          * Use the `_parent_id` field to create this row as a subspan of an existing row. It cannot
          * be specified alongside `_is_merge=true`. Tracking hierarchical relationships are
-         * important for tracing (see the [guide](https://www.braintrust.dev/docs/guides/tracing)
-         * for full details).
+         * important for tracing (see the [guide](https://www.braintrust.dev/docs/instrument) for
+         * full details).
          *
          * For example, say we have logged a row `{"id": "abc", "input": "foo", "output": "bar",
          * "expected": "boo", "scores": {"correctness": 0.33}}`. We can create a sub-span of the
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogFetchPostParams.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogFetchPostParams.kt
index 16c32c43..e53c82b5 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogFetchPostParams.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogFetchPostParams.kt
@@ -90,7 +90,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
@@ -227,7 +227,7 @@ constructor(
 
             /**
              * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-             * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+             * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
              * advanced filtering.
              *
              * A list of filters on the events to fetch. Currently, only path-lookup type filters
@@ -409,7 +409,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
@@ -422,7 +422,7 @@ constructor(
 
         /**
          * NOTE: This parameter is deprecated and will be removed in a future revision. Consider
-         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/btql) for more
+         * using the `/btql` endpoint (https://www.braintrust.dev/docs/reference/sql) for more
          * advanced filtering.
          *
          * A list of filters on the events to fetch. Currently, only path-lookup type filters are
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogsEvent.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogsEvent.kt
index 618dd3b3..bef69ced 100755
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogsEvent.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/models/ProjectLogsEvent.kt
@@ -137,8 +137,8 @@ private constructor(
 
     /**
      * A unique identifier used to link different project logs events together as part of a full
-     * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
-     * details on tracing
+     * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full details
+     * on tracing
      */
     fun spanId(): String = spanId.getRequired("span_id")
 
@@ -243,8 +243,8 @@ private constructor(
 
     /**
      * A unique identifier used to link different project logs events together as part of a full
-     * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
-     * details on tracing
+     * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full details
+     * on tracing
      */
     @JsonProperty("span_id") @ExcludeMissing fun _spanId() = spanId
 
@@ -583,14 +583,14 @@ private constructor(
 
         /**
          * A unique identifier used to link different project logs events together as part of a full
-         * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
+         * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full
          * details on tracing
          */
         fun spanId(spanId: String) = spanId(JsonField.of(spanId))
 
         /**
          * A unique identifier used to link different project logs events together as part of a full
-         * trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full
+         * trace. See the [tracing guide](https://www.braintrust.dev/docs/instrument) for full
          * details on tracing
          */
         @JsonProperty("span_id")
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsync.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsync.kt
index a5db23db..d47237e3 100644
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsync.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsync.kt
@@ -15,7 +15,7 @@ interface EvalServiceAsync {
      * the Braintrust SDK. In the Eval API, you provide pointers to a dataset, task function, and
      * scoring functions. The API will then run the evaluation, create an experiment, and return the
      * results along with a link to the experiment. To learn more about evals, see the
-     * [Evals guide](https://www.braintrust.dev/docs/guides/evals).
+     * [Evals guide](https://www.braintrust.dev/docs/evaluate/run-evaluations).
      */
     suspend fun create(
         params: EvalCreateParams,
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsyncImpl.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsyncImpl.kt
index a5708ed1..797c56ca 100644
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsyncImpl.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/async/EvalServiceAsyncImpl.kt
@@ -31,7 +31,7 @@ constructor(
      * the Braintrust SDK. In the Eval API, you provide pointers to a dataset, task function, and
      * scoring functions. The API will then run the evaluation, create an experiment, and return the
      * results along with a link to the experiment. To learn more about evals, see the
-     * [Evals guide](https://www.braintrust.dev/docs/guides/evals).
+     * [Evals guide](https://www.braintrust.dev/docs/evaluate/run-evaluations).
      */
     override suspend fun create(
         params: EvalCreateParams,
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalService.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalService.kt
index f9242a7c..e27fa2cf 100644
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalService.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalService.kt
@@ -15,7 +15,7 @@ interface EvalService {
      * the Braintrust SDK. In the Eval API, you provide pointers to a dataset, task function, and
      * scoring functions. The API will then run the evaluation, create an experiment, and return the
      * results along with a link to the experiment. To learn more about evals, see the
-     * [Evals guide](https://www.braintrust.dev/docs/guides/evals).
+     * [Evals guide](https://www.braintrust.dev/docs/evaluate/run-evaluations).
      */
     fun create(
         params: EvalCreateParams,
diff --git a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalServiceImpl.kt b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalServiceImpl.kt
index 2811b4d7..c2d462ac 100644
--- a/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalServiceImpl.kt
+++ b/braintrust-kotlin-core/src/main/kotlin/com/braintrustdata/api/services/blocking/EvalServiceImpl.kt
@@ -31,7 +31,7 @@ constructor(
      * the Braintrust SDK. In the Eval API, you provide pointers to a dataset, task function, and
      * scoring functions. The API will then run the evaluation, create an experiment, and return the
      * results along with a link to the experiment. To learn more about evals, see the
-     * [Evals guide](https://www.braintrust.dev/docs/guides/evals).
+     * [Evals guide](https://www.braintrust.dev/docs/evaluate/run-evaluations).
      */
     override fun create(
         params: EvalCreateParams,