release: 9.9.0

.github/workflows/ci.yml

@@ -21,10 +21,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/finch-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: '22'
 
@@ -43,10 +43,10 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: '22'
 
@@ -61,7 +61,7 @@ jobs:
           github.repository == 'stainless-sdks/finch-typescript' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -91,10 +91,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/finch-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: '22'
 

.github/workflows/publish-npm.yml

@@ -21,10 +21,10 @@ jobs:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Node
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@3235b876344d2a9aa001b8d1453c930bba69e610 # v3.9.1
         with:
           node-version: '20'
 

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'Finch-API/finch-api-node' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "9.8.0"
+  ".": "9.9.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-c8a0d5eca390ea3ab6e8b5b7d9b46d9a22e34d81aeab444c8ce1b5a94eba0028.yml
-openapi_spec_hash: e261a3289242d3ad52542f1491a903ee
-config_hash: 429708b67ee9e80003db82611677296c
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-82224679b895da7c7a5aae44d11b69fbe37d0316cd8e10aa0c89bc5a68f424de.yml
+openapi_spec_hash: a4ca94b3405fc83934c949068943e16c
+config_hash: fce67e71044aa4c3d0b8030052b3a20b

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 9.9.0 (2026-05-12)
+
+Full Changelog: [v9.8.0...v9.9.0](https://github.com/Finch-API/finch-api-node/compare/v9.8.0...v9.9.0)
+
+### Features
+
+* **api:** api update ([c3c7ce0](https://github.com/Finch-API/finch-api-node/commit/c3c7ce088d83b5ec87c73576f4db788b5a5365a0))
+* **api:** manual updates ([4b8185b](https://github.com/Finch-API/finch-api-node/commit/4b8185b9bc71035c6415e6f9a7953f6a20c93048))
+* **api:** manual updates ([a91d7f6](https://github.com/Finch-API/finch-api-node/commit/a91d7f68d670d794bf014350c0f2f632332e874f))
+
 ## 9.8.0 (2026-05-07)
 
 Full Changelog: [v9.7.0...v9.8.0](https://github.com/Finch-API/finch-api-node/compare/v9.7.0...v9.8.0)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryfinch/finch-api",
-  "version": "9.8.0",
+  "version": "9.9.0",
   "description": "The official TypeScript library for the Finch API",
   "author": "Finch <founders@tryfinch.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.2",
   "name": "@tryfinch/finch-api-mcp",
-  "version": "9.8.0",
+  "version": "9.9.0",
   "description": "The official MCP Server for the Finch API",
   "author": {
     "name": "Finch",

packages/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryfinch/finch-api-mcp",
-  "version": "9.8.0",
+  "version": "9.9.0",
   "description": "The official MCP Server for the Finch API",
   "author": "Finch <founders@tryfinch.com>",
   "types": "dist/index.d.ts",

packages/mcp-server/src/server.ts

@@ -29,7 +29,7 @@ export const newMcpServer = async ({
   new McpServer(
     {
       name: 'tryfinch_finch_api_api',
-      version: '9.8.0',
+      version: '9.9.0',
     },
     {
       instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),

src/resources/hris/employments.ts

@@ -36,10 +36,10 @@ export class Employments extends APIResource {
 
 export type EmploymentDataResponsesPage = ResponsesPage<EmploymentDataResponse>;
 
-export type EmploymentData = EmploymentData.EmploymentData | EmploymentData.BatchError;
+export type EmploymentData = EmploymentData.EmploymentDataResponseBody | EmploymentData.BatchError;
 
 export namespace EmploymentData {
-  export interface EmploymentData {
+  export interface EmploymentDataResponseBody {
     /**
      * A stable Finch `id` (UUID v4) for an individual in the company.
      */
@@ -53,12 +53,12 @@ export namespace EmploymentData {
     /**
      * The department object.
      */
-    department: EmploymentData.Department | null;
+    department: EmploymentDataResponseBody.Department | null;
 
     /**
      * The employment object.
      */
-    employment: EmploymentData.Employment | null;
+    employment: EmploymentDataResponseBody.Employment | null;
 
     /**
      * The detailed employment status of the individual.
@@ -103,7 +103,7 @@ export namespace EmploymentData {
     /**
      * The manager object representing the manager of the individual within the org.
      */
-    manager: EmploymentData.Manager | null;
+    manager: EmploymentDataResponseBody.Manager | null;
 
     /**
      * The legal middle name of the individual.
@@ -122,7 +122,7 @@ export namespace EmploymentData {
      * employer in the system. Custom fields are not currently supported for assisted
      * connections.
      */
-    custom_fields?: Array<EmploymentData.CustomField> | null;
+    custom_fields?: Array<EmploymentDataResponseBody.CustomField> | null;
 
     /**
      * The employee's income as reported by the provider. This may not always be
@@ -147,7 +147,7 @@ export namespace EmploymentData {
     work_id?: string | null;
   }
 
-  export namespace EmploymentData {
+  export namespace EmploymentDataResponseBody {
     /**
      * The department object.
      */

src/resources/hris/individuals.ts

@@ -34,10 +34,10 @@ export class Individuals extends APIResource {
 
 export type IndividualResponsesPage = ResponsesPage<IndividualResponse>;
 
-export type Individual = Individual.Individual | Individual.BatchError;
+export type Individual = Individual.IndividualResponseBody | Individual.BatchError;
 
 export namespace Individual {
-  export interface Individual {
+  export interface IndividualResponseBody {
     /**
      * A stable Finch `id` (UUID v4) for an individual in the company.
      */
@@ -79,7 +79,7 @@ export namespace Individual {
      */
     middle_name: string | null;
 
-    phone_numbers: Array<Individual.PhoneNumber | null> | null;
+    phone_numbers: Array<IndividualResponseBody.PhoneNumber | null> | null;
 
     /**
      * The preferred name of the individual.
@@ -88,7 +88,7 @@ export namespace Individual {
 
     residence: HRISAPI.Location | null;
 
-    emails?: Array<Individual.Email> | null;
+    emails?: Array<IndividualResponseBody.Email> | null;
 
     /**
      * Social Security Number of the individual in **encrypted** format. This field is
@@ -106,7 +106,7 @@ export namespace Individual {
     ssn?: string | null;
   }
 
-  export namespace Individual {
+  export namespace IndividualResponseBody {
     export interface PhoneNumber {
       data: string | null;
 

src/resources/sandbox/directory.ts

@@ -190,7 +190,7 @@ export namespace DirectoryCreateParams {
     export interface CustomField {
       name?: string | null;
 
-      value?: unknown;
+      value?: string | null | Array<unknown> | null | unknown | number | null | boolean | null;
     }
 
     /**

src/resources/sandbox/employment.ts

@@ -14,6 +14,7 @@ export class Employment extends APIResource {
    * ```ts
    * const employment = await client.sandbox.employment.update(
    *   'individual_id',
+   *   { start_date: '3/4/2020' },
    * );
    * ```
    */
@@ -137,7 +138,7 @@ export namespace EmploymentUpdateResponse {
   export interface CustomField {
     name?: string | null;
 
-    value?: unknown;
+    value?: string | null | Array<unknown> | null | unknown | number | null | boolean | null;
   }
 
   /**
@@ -279,7 +280,7 @@ export namespace EmploymentUpdateParams {
   export interface CustomField {
     name?: string | null;
 
-    value?: unknown;
+    value?: string | null | Array<unknown> | null | unknown | number | null | boolean | null;
   }
 
   /**

src/version.ts

@@ -1 +1 @@
-export const VERSION = '9.8.0'; // x-release-please-version
+export const VERSION = '9.9.0'; // x-release-please-version

tests/api-resources/sandbox/directory.test.ts

@@ -29,12 +29,7 @@ describe('resource directory', () => {
           body: [
             {
               class_code: 'class_code',
-              custom_fields: [
-                {
-                  name: 'name',
-                  value: {},
-                },
-              ],
+              custom_fields: [{ name: 'name', value: 'string' }],
               department: { name: 'name' },
               dob: 'dob',
               emails: [{ data: 'data', type: 'work' }],

tests/api-resources/sandbox/employment.test.ts

@@ -28,12 +28,7 @@ describe('resource employment', () => {
         'individual_id',
         {
           class_code: 'class_code',
-          custom_fields: [
-            {
-              name: 'name',
-              value: {},
-            },
-          ],
+          custom_fields: [{ name: 'name', value: 'string' }],
           department: { name: 'name' },
           employment: { subtype: 'full_time', type: 'employee' },
           employment_status: 'active',
@@ -70,7 +65,7 @@ describe('resource employment', () => {
           manager: { id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
           middle_name: 'middle_name',
           source_id: 'source_id',
-          start_date: 'start_date',
+          start_date: '3/4/2020',
           title: 'title',
         },
         { path: '/_stainless_unknown_path' },