diff --git a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScore.kt b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScore.kt
index 6f268c6e..56f66f2a 100755
--- a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScore.kt
+++ b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScore.kt
@@ -67,6 +67,7 @@ private constructor(
     /** The type of the configured score */
     fun scoreType(): ProjectScoreType = scoreType.getRequired("score_type")
 
+    /** For categorical-type project scores, the list of all categories */
     fun categories(): Optional<Categories> =
         Optional.ofNullable(categories.getNullable("categories"))
 
@@ -95,6 +96,7 @@ private constructor(
     /** The type of the configured score */
     @JsonProperty("score_type") @ExcludeMissing fun _scoreType() = scoreType
 
+    /** For categorical-type project scores, the list of all categories */
     @JsonProperty("categories") @ExcludeMissing fun _categories() = categories
 
     @JsonProperty("config") @ExcludeMissing fun _config() = config
@@ -210,8 +212,10 @@ private constructor(
         @ExcludeMissing
         fun scoreType(scoreType: JsonField<ProjectScoreType>) = apply { this.scoreType = scoreType }
 
+        /** For categorical-type project scores, the list of all categories */
         fun categories(categories: Categories) = categories(JsonField.of(categories))
 
+        /** For categorical-type project scores, the list of all categories */
         @JsonProperty("categories")
         @ExcludeMissing
         fun categories(categories: JsonField<Categories>) = apply { this.categories = categories }
diff --git a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreCreateParams.kt b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreCreateParams.kt
index cf6447ea..f721e169 100755
--- a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreCreateParams.kt
+++ b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreCreateParams.kt
@@ -89,6 +89,7 @@ constructor(
         /** The type of the configured score */
         @JsonProperty("score_type") fun scoreType(): ProjectScoreType? = scoreType
 
+        /** For categorical-type project scores, the list of all categories */
         @JsonProperty("categories") fun categories(): Categories? = categories
 
         @JsonProperty("config") fun config(): ProjectScoreConfig? = config
@@ -139,6 +140,7 @@ constructor(
             @JsonProperty("score_type")
             fun scoreType(scoreType: ProjectScoreType) = apply { this.scoreType = scoreType }
 
+            /** For categorical-type project scores, the list of all categories */
             @JsonProperty("categories")
             fun categories(categories: Categories) = apply { this.categories = categories }
 
diff --git a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreReplaceParams.kt b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreReplaceParams.kt
index 325ff57f..704ca8a7 100755
--- a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreReplaceParams.kt
+++ b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreReplaceParams.kt
@@ -89,6 +89,7 @@ constructor(
         /** The type of the configured score */
         @JsonProperty("score_type") fun scoreType(): ProjectScoreType? = scoreType
 
+        /** For categorical-type project scores, the list of all categories */
         @JsonProperty("categories") fun categories(): Categories? = categories
 
         @JsonProperty("config") fun config(): ProjectScoreConfig? = config
@@ -139,6 +140,7 @@ constructor(
             @JsonProperty("score_type")
             fun scoreType(scoreType: ProjectScoreType) = apply { this.scoreType = scoreType }
 
+            /** For categorical-type project scores, the list of all categories */
             @JsonProperty("categories")
             fun categories(categories: Categories) = apply { this.categories = categories }
 
diff --git a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreUpdateParams.kt b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreUpdateParams.kt
index ca58dad5..eea95b00 100755
--- a/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreUpdateParams.kt
+++ b/braintrust-java-core/src/main/kotlin/com/braintrustdata/api/models/ProjectScoreUpdateParams.kt
@@ -85,6 +85,7 @@ constructor(
         private val additionalProperties: Map<String, JsonValue>,
     ) {
 
+        /** For categorical-type project scores, the list of all categories */
         @JsonProperty("categories") fun categories(): Categories? = categories
 
         @JsonProperty("config") fun config(): ProjectScoreConfig? = config
@@ -128,6 +129,7 @@ constructor(
                 additionalProperties(projectScoreUpdateBody.additionalProperties)
             }
 
+            /** For categorical-type project scores, the list of all categories */
             @JsonProperty("categories")
             fun categories(categories: Categories) = apply { this.categories = categories }