release: 8.2.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "8.1.0"
+  ".": "8.2.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 48
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-3cd1346947fabfca2aa9c6f821170c8d945a82667fb20a15644d5c77f8e98c10.yml
-openapi_spec_hash: 642e04e90d37c0e4875d154abd06eb54
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-a6b05e51c46366a54466c2009f5fdde74e0fa40bbcc6568601a4e3342dd16937.yml
+openapi_spec_hash: 084797c220144df17d98eb984dd4cba2
 config_hash: 9ae56f40cec7304896138bfad5caf748

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 8.2.0 (2026-07-13)
+
+Full Changelog: [v8.1.0...v8.2.0](https://github.com/Finch-API/finch-api-java/compare/v8.1.0...v8.2.0)
+
+### Features
+
+* **api:** api update ([3de68b0](https://github.com/Finch-API/finch-api-java/commit/3de68b03ee9fe17eb3c14e26d238a74e3ffcc8fc))
+
 ## 8.1.0 (2026-07-01)
 
 Full Changelog: [v8.0.1...v8.1.0](https://github.com/Finch-API/finch-api-java/compare/v8.0.1...v8.1.0)

README.md

@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.tryfinch.api/finch-java)](https://central.sonatype.com/artifact/com.tryfinch.api/finch-java/8.1.0)
-[![javadoc](https://javadoc.io/badge2/com.tryfinch.api/finch-java/8.1.0/javadoc.svg)](https://javadoc.io/doc/com.tryfinch.api/finch-java/8.1.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.tryfinch.api/finch-java)](https://central.sonatype.com/artifact/com.tryfinch.api/finch-java/8.2.0)
+[![javadoc](https://javadoc.io/badge2/com.tryfinch.api/finch-java/8.2.0/javadoc.svg)](https://javadoc.io/doc/com.tryfinch.api/finch-java/8.2.0)
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ Use the Finch MCP Server to enable AI assistants to interact with this API, allo
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [developer.tryfinch.com](https://developer.tryfinch.com/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.tryfinch.api/finch-java/8.1.0).
+The REST API documentation can be found on [developer.tryfinch.com](https://developer.tryfinch.com/). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.tryfinch.api/finch-java/8.2.0).
 
 <!-- x-release-please-end -->
 
@@ -35,7 +35,7 @@ The REST API documentation can be found on [developer.tryfinch.com](https://deve
 ### Gradle
 
 ```kotlin
-implementation("com.tryfinch.api:finch-java:8.1.0")
+implementation("com.tryfinch.api:finch-java:8.2.0")
 ```
 
 ### Maven
@@ -44,7 +44,7 @@ implementation("com.tryfinch.api:finch-java:8.1.0")
 <dependency>
   <groupId>com.tryfinch.api</groupId>
   <artifactId>finch-java</artifactId>
-  <version>8.1.0</version>
+  <version>8.2.0</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.tryfinch.api"
-    version = "8.1.0" // x-release-please-version
+    version = "8.2.0" // x-release-please-version
 }
 
 subprojects {

finch-java-core/src/main/kotlin/com/tryfinch/api/models/HrisDirectoryListIndividualsParams.kt

@@ -24,7 +24,7 @@ private constructor(
     /** The entity IDs to specify which entities' data to access. */
     fun entityIds(): Optional<List<String>> = Optional.ofNullable(entityIds)
 
-    /** Number of employees to return (defaults to all) */
+    /** Number of employees to return (defaults to 100, maximum 10000) */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
     /** Index to start from (defaults to 0) */
@@ -86,7 +86,7 @@ private constructor(
             entityIds = (entityIds ?: mutableListOf()).apply { add(entityId) }
         }
 
-        /** Number of employees to return (defaults to all) */
+        /** Number of employees to return (defaults to 100, maximum 10000) */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**

finch-java-core/src/main/kotlin/com/tryfinch/api/models/HrisDirectoryListParams.kt

@@ -23,7 +23,7 @@ private constructor(
     /** The entity IDs to specify which entities' data to access. */
     fun entityIds(): Optional<List<String>> = Optional.ofNullable(entityIds)
 
-    /** Number of employees to return (defaults to all) */
+    /** Number of employees to return (defaults to 100, maximum 10000) */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
     /** Index to start from (defaults to 0) */
@@ -80,7 +80,7 @@ private constructor(
             entityIds = (entityIds ?: mutableListOf()).apply { add(entityId) }
         }
 
-        /** Number of employees to return (defaults to all) */
+        /** Number of employees to return (defaults to 100, maximum 10000) */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**

finch-java-core/src/main/kotlin/com/tryfinch/api/models/HrisEmploymentRetrieveManyParams.kt

@@ -35,7 +35,7 @@ private constructor(
     fun entityIds(): Optional<List<String>> = Optional.ofNullable(entityIds)
 
     /**
-     * The array of batch requests.
+     * The array of batch requests. Maximum 10000 items per request.
      *
      * @throws FinchInvalidDataException if the JSON field has an unexpected type or is unexpectedly
      *   missing or null (e.g. if the server responded with an unexpected value).
@@ -117,7 +117,7 @@ private constructor(
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
 
-        /** The array of batch requests. */
+        /** The array of batch requests. Maximum 10000 items per request. */
         fun requests(requests: List<Request>) = apply { body.requests(requests) }
 
         /**
@@ -302,7 +302,7 @@ private constructor(
         ) : this(requests, mutableMapOf())
 
         /**
-         * The array of batch requests.
+         * The array of batch requests. Maximum 10000 items per request.
          *
          * @throws FinchInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -355,7 +355,7 @@ private constructor(
                 additionalProperties = body.additionalProperties.toMutableMap()
             }
 
-            /** The array of batch requests. */
+            /** The array of batch requests. Maximum 10000 items per request. */
             fun requests(requests: List<Request>) = requests(JsonField.of(requests))
 
             /**
@@ -490,9 +490,7 @@ private constructor(
         ) : this(individualId, mutableMapOf())
 
         /**
-         * A stable Finch `id` (UUID v4) for an individual in the company. There is no limit to the
-         * number of `individual_id` to send per request. It is preferantial to send all ids in a
-         * single request for Finch to optimize provider rate-limits.
+         * A stable Finch `id` (UUID v4) for an individual in the company.
          *
          * @throws FinchInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -546,11 +544,7 @@ private constructor(
                 additionalProperties = request.additionalProperties.toMutableMap()
             }
 
-            /**
-             * A stable Finch `id` (UUID v4) for an individual in the company. There is no limit to
-             * the number of `individual_id` to send per request. It is preferantial to send all ids
-             * in a single request for Finch to optimize provider rate-limits.
-             */
+            /** A stable Finch `id` (UUID v4) for an individual in the company. */
             fun individualId(individualId: String) = individualId(JsonField.of(individualId))
 
             /**