diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 26817e153..371dbbd24 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.478.0"
+  ".": "0.479.0"
 }
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index c0c45d4b9..c2ad6972f 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 236
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-81da26cfd6540bc5195c268095b26df132373e932997f224d19247a36e1a1183.yml
-openapi_spec_hash: 7b9bbc35378f2fc47629810923bd0017
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-f8f6ba45132556b8cd3b7aec8578241638d4774e41ac769df78731d919c1825f.yml
+openapi_spec_hash: 9c80a378f9fb89d648f47596aef948d9
 config_hash: 25d7d7aa4882db6189b4b53e8e249e80
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7af4fe7d9..b400e4bfe 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.479.0 (2026-03-16)
+
+Full Changelog: [v0.478.0...v0.479.0](https://github.com/Increase/increase-java/compare/v0.478.0...v0.479.0)
+
+### Features
+
+* **api:** api update ([c0ca8eb](https://github.com/Increase/increase-java/commit/c0ca8eb66bed18afa37ab870db08b96dd9dabe3c))
+
 ## 0.478.0 (2026-03-16)
 
 Full Changelog: [v0.477.0...v0.478.0](https://github.com/Increase/increase-java/compare/v0.477.0...v0.478.0)
diff --git a/README.md b/README.md
index 8ab5b30d4..e9800a726 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.478.0)
-[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.478.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.478.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.479.0)
+[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.479.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.479.0)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ The Increase Java SDK is similar to the Increase Kotlin SDK but with minor diffe
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.478.0).
+The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.479.0).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [increase.com](https://increase.com/d
 ### Gradle
 
 ```kotlin
-implementation("com.increase.api:increase-java:0.478.0")
+implementation("com.increase.api:increase-java:0.479.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.increase.api:increase-java:0.478.0")
 <dependency>
   <groupId>com.increase.api</groupId>
   <artifactId>increase-java</artifactId>
-  <version>0.478.0</version>
+  <version>0.479.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index 57e04fbde..0e76d3511 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.increase.api"
-    version = "0.478.0" // x-release-please-version
+    version = "0.479.0" // x-release-please-version
 }
 
 subprojects {
diff --git a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt
index fdc1279fc..bbe503746 100644
--- a/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt
+++ b/increase-java-core/src/main/kotlin/com/increase/api/models/entities/Entity.kt
@@ -270,7 +270,8 @@ private constructor(
     fun type(): Type = type.getRequired("type")
 
     /**
-     * The validation results for the entity.
+     * The validation results for the entity. Learn more about
+     * [validations](/documentation/entity-validation).
      *
      * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -841,7 +842,10 @@ private constructor(
          */
         fun type(type: JsonField<Type>) = apply { this.type = type }
 
-        /** The validation results for the entity. */
+        /**
+         * The validation results for the entity. Learn more about
+         * [validations](/documentation/entity-validation).
+         */
         fun validation(validation: Validation?) = validation(JsonField.ofNullable(validation))
 
         /** Alias for calling [Builder.validation] with `validation.orElse(null)`. */
@@ -11534,7 +11538,10 @@ private constructor(
         override fun toString() = value.toString()
     }
 
-    /** The validation results for the entity. */
+    /**
+     * The validation results for the entity. Learn more about
+     * [validations](/documentation/entity-validation).
+     */
     class Validation
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(