Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
62 commits
Select commit Hold shift + click to select a range
f342729
chore(ci): upgrade `actions/github-script`
stainless-app[bot] Jan 23, 2026
686b27e
feat(api): add per endpoint security
stainless-app[bot] Jan 26, 2026
b746d12
chore(internal): codegen related update
stainless-app[bot] Jan 26, 2026
e22eb0f
fix(tests): skip broken date validation test
stainless-app[bot] Jan 26, 2026
298ddec
fix(docs): fix mcp installation instructions for remote servers
stainless-app[bot] Jan 28, 2026
02cb5a0
feat(client): add custom JSON encoder for extended type support
stainless-app[bot] Jan 29, 2026
0b67a64
chore(internal): bump dependencies
stainless-app[bot] Feb 9, 2026
b0f5ba3
chore(internal): fix lint error on Python 3.14
stainless-app[bot] Feb 11, 2026
8555964
chore: format all `api.md` files
stainless-app[bot] Feb 12, 2026
7891a91
chore: update mock server docs
stainless-app[bot] Feb 19, 2026
977dcfa
chore(internal): add request options to SSE classes
stainless-app[bot] Feb 23, 2026
e33584f
chore(internal): make `test_proxy_environment_variables` more resilient
stainless-app[bot] Feb 23, 2026
9f092c7
chore(internal): make `test_proxy_environment_variables` more resilie…
stainless-app[bot] Feb 24, 2026
565de84
fix(api): remove invalid transform config
stainless-app[bot] Mar 10, 2026
c6631fc
feat(api): api update
stainless-app[bot] Mar 10, 2026
94aae5c
chore(internal): codegen related update
stainless-app[bot] Apr 14, 2026
0d13335
chore(ci): skip uploading artifacts on stainless-internal branches
stainless-app[bot] Mar 10, 2026
399bc94
fix(pydantic): do not pass `by_alias` unless set
stainless-app[bot] Mar 16, 2026
16af387
fix(deps): bump minimum typing-extensions version
stainless-app[bot] Mar 16, 2026
9e540f1
chore(internal): tweak CI branches
stainless-app[bot] Mar 16, 2026
0774137
codegen metadata
stainless-app[bot] Mar 17, 2026
896338f
fix: sanitize endpoint path params
stainless-app[bot] Mar 19, 2026
8ff1f27
refactor(tests): switch from prism to steady
stainless-app[bot] Mar 19, 2026
bfdc74c
chore(tests): bump steady to v0.19.4
stainless-app[bot] Mar 20, 2026
2822044
chore(tests): bump steady to v0.19.5
stainless-app[bot] Mar 20, 2026
fd09507
chore(internal): update gitignore
stainless-app[bot] Mar 23, 2026
b3457c1
chore(tests): bump steady to v0.19.6
stainless-app[bot] Mar 23, 2026
2f97b57
chore(ci): skip lint on metadata-only changes
stainless-app[bot] Mar 24, 2026
634c5ef
chore(tests): bump steady to v0.19.7
stainless-app[bot] Mar 24, 2026
f5a025a
codegen metadata
stainless-app[bot] Mar 24, 2026
9736c48
feat(api): api update
stainless-app[bot] Mar 25, 2026
a8f9575
feat(internal): implement indices array format for query and form ser…
stainless-app[bot] Mar 26, 2026
bfd4d9c
codegen metadata
stainless-app[bot] Mar 27, 2026
f92438d
chore(tests): bump steady to v0.20.1
stainless-app[bot] Mar 31, 2026
2abc18d
chore(tests): bump steady to v0.20.2
stainless-app[bot] Mar 31, 2026
e9413d1
fix(client): preserve hardcoded query params when merging with user p…
stainless-app[bot] Apr 7, 2026
028a805
fix: ensure file data are only sent as 1 parameter
stainless-app[bot] Apr 10, 2026
0a947a8
feat(api): api update
stainless-app[bot] Apr 10, 2026
2db6842
codegen metadata
stainless-app[bot] Apr 10, 2026
c4bd9ea
feat(api): api update
stainless-app[bot] Apr 16, 2026
4c5544c
perf(client): optimize file structure copying in multipart requests
stainless-app[bot] Apr 17, 2026
78e1421
chore(tests): bump steady to v0.22.1
stainless-app[bot] Apr 17, 2026
524ba9e
chore(internal): more robust bootstrap script
stainless-app[bot] Apr 22, 2026
0608eea
feat(api): api update
stainless-app[bot] Apr 23, 2026
f952a4d
fix: use correct field name format for multipart file arrays
stainless-app[bot] Apr 27, 2026
e3efcee
feat: support setting headers via env
stainless-app[bot] Apr 27, 2026
0754983
codegen metadata
stainless-app[bot] Apr 29, 2026
b252784
codegen metadata
stainless-app[bot] Apr 30, 2026
5fa44b4
codegen metadata
stainless-app[bot] Apr 30, 2026
d713cd0
chore(internal): reformat pyproject.toml
stainless-app[bot] Apr 30, 2026
abb9fa0
feat(api): api update
stainless-app[bot] May 1, 2026
99e028e
fix(client): add missing f-string prefix in file type error message
stainless-app[bot] May 8, 2026
04753d4
feat(internal/types): support eagerly validating pydantic iterators
stainless-app[bot] May 11, 2026
264b9fc
ci: pin GitHub Actions to commit SHAs
stainless-app[bot] May 12, 2026
581ee7c
feat(api): api update
stainless-app[bot] May 12, 2026
d64958b
chore(auth): remove custom header handling code (#692)
jordanbrauer May 12, 2026
7708a43
feat(api): manual updates
stainless-app[bot] May 12, 2026
fce5481
codegen metadata
stainless-app[bot] May 12, 2026
d7caac4
feat(api): add register benefits method
stainless-app[bot] May 12, 2026
f22aab4
fix(aliases): resolve broken types for alias methods with pagination
stainless-app[bot] May 13, 2026
b62b5f9
codegen metadata
stainless-app[bot] May 15, 2026
bcff6dc
release: 1.45.0
stainless-app[bot] May 15, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 20 additions & 14 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -1,12 +1,14 @@
name: CI
on:
push:
branches-ignore:
- 'generated'
- 'codegen/**'
- 'integrated/**'
- 'stl-preview-head/**'
- 'stl-preview-base/**'
branches:
- '**'
- '!integrated/**'
- '!stl-preview-head/**'
- '!stl-preview-base/**'
- '!generated'
- '!codegen/**'
- 'codegen/stl/**'
pull_request:
branches-ignore:
- 'stl-preview-head/**'
Expand All @@ -17,9 +19,9 @@ jobs:
timeout-minutes: 10
name: lint
runs-on: ${{ github.repository == 'stainless-sdks/finch-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
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: Install Rye
run: |
Expand All @@ -36,15 +38,15 @@ jobs:
run: ./scripts/lint

build:
if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
timeout-minutes: 10
name: build
permissions:
contents: read
id-token: write
runs-on: ${{ github.repository == 'stainless-sdks/finch-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

- name: Install Rye
run: |
Expand All @@ -61,14 +63,18 @@ jobs:
run: rye build

- name: Get GitHub OIDC Token
if: github.repository == 'stainless-sdks/finch-python'
if: |-
github.repository == 'stainless-sdks/finch-python' &&
!startsWith(github.ref, 'refs/heads/stl/')
id: github-oidc
uses: actions/github-script@v6
uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
with:
script: core.setOutput('github_token', await core.getIDToken());

- name: Upload tarball
if: github.repository == 'stainless-sdks/finch-python'
if: |-
github.repository == 'stainless-sdks/finch-python' &&
!startsWith(github.ref, 'refs/heads/stl/')
env:
URL: https://pkg.stainless.com/s
AUTH: ${{ steps.github-oidc.outputs.github_token }}
Expand All @@ -81,7 +87,7 @@ jobs:
runs-on: ${{ github.repository == 'stainless-sdks/finch-python' && '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: Install Rye
run: |
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/publish-pypi.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ jobs:
runs-on: ubuntu-latest

steps:
- uses: actions/checkout@v6
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

- name: Install Rye
run: |
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/release-doctor.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ jobs:
if: github.repository == 'Finch-API/finch-api-python' && (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: |
Expand Down
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
.prism.log
.stdy.log
_dev

__pycache__
Expand Down
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "1.44.1"
".": "1.45.0"
}
8 changes: 4 additions & 4 deletions .stats.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 46
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-46f433f34d440aa1dfcc48cc8d822c598571b68be2f723ec99e1b4fba6c13b1e.yml
openapi_spec_hash: 5b5cd728776723ac773900f7e8a32c05
config_hash: 0892e2e0eeb0343a022afa62e9080dd1
configured_endpoints: 48
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch/finch-8a983c70d7cbbc4023463a85ebdabcee1645603ab46337aa9cfa18f1872f0ae1.yml
openapi_spec_hash: a4ca94b3405fc83934c949068943e16c
config_hash: 812b56df3e506bc2af056b2898327b8a
74 changes: 74 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,79 @@
# Changelog

## 1.45.0 (2026-05-15)

Full Changelog: [v1.44.1...v1.45.0](https://github.com/Finch-API/finch-api-python/compare/v1.44.1...v1.45.0)

### Features

* **api:** add per endpoint security ([686b27e](https://github.com/Finch-API/finch-api-python/commit/686b27e6d19cc5858b420e2b1bb265f50791c7ea))
* **api:** add register benefits method ([d7caac4](https://github.com/Finch-API/finch-api-python/commit/d7caac40edd435141d67d2033a60719d6867e8dc))
* **api:** api update ([581ee7c](https://github.com/Finch-API/finch-api-python/commit/581ee7c9372b4eb5dd5858a0aa32bed0edb3a470))
* **api:** api update ([abb9fa0](https://github.com/Finch-API/finch-api-python/commit/abb9fa0f5555143e8dfcd483e859d4a2a6d5c9c0))
* **api:** api update ([0608eea](https://github.com/Finch-API/finch-api-python/commit/0608eea99892801e0575da4731a5717a3360be4b))
* **api:** api update ([c4bd9ea](https://github.com/Finch-API/finch-api-python/commit/c4bd9ea002acfc7aec3f1413d97f71040000e0c9))
* **api:** api update ([0a947a8](https://github.com/Finch-API/finch-api-python/commit/0a947a818fb4b1ccfe17cf7ee7a21b6d3c9d1bcc))
* **api:** api update ([9736c48](https://github.com/Finch-API/finch-api-python/commit/9736c482b0e58023b806d55096a7d271395efdbb))
* **api:** api update ([c6631fc](https://github.com/Finch-API/finch-api-python/commit/c6631fc8d74f89931be556746c6ce67e4cb62867))
* **api:** manual updates ([7708a43](https://github.com/Finch-API/finch-api-python/commit/7708a432267ae51d4ec98f21747c7fa5d7364b8c))
* **client:** add custom JSON encoder for extended type support ([02cb5a0](https://github.com/Finch-API/finch-api-python/commit/02cb5a0bdcdbd8b4652937928ca7d0b336f6c53c))
* **internal/types:** support eagerly validating pydantic iterators ([04753d4](https://github.com/Finch-API/finch-api-python/commit/04753d43634c69c6928d230c5c60c4846de1d536))
* **internal:** implement indices array format for query and form serialization ([a8f9575](https://github.com/Finch-API/finch-api-python/commit/a8f9575597da48d407feac3c4d13d592b4241192))
* support setting headers via env ([e3efcee](https://github.com/Finch-API/finch-api-python/commit/e3efceee56e129cc009ba0124341b49ad808f283))


### Bug Fixes

* **aliases:** resolve broken types for alias methods with pagination ([f22aab4](https://github.com/Finch-API/finch-api-python/commit/f22aab4df6b44baaf33724a64c18351a8902a58f))
* **api:** remove invalid transform config ([565de84](https://github.com/Finch-API/finch-api-python/commit/565de8480f61bf07d5dbd0fb39fbb8b4f5ea9671))
* **client:** add missing f-string prefix in file type error message ([99e028e](https://github.com/Finch-API/finch-api-python/commit/99e028ee64f045980b7245948adc86b02ffeb63f))
* **client:** preserve hardcoded query params when merging with user params ([e9413d1](https://github.com/Finch-API/finch-api-python/commit/e9413d1d2f5684edd21808cb199e7b4cae9375f6))
* **deps:** bump minimum typing-extensions version ([16af387](https://github.com/Finch-API/finch-api-python/commit/16af387fd95f0207db3ce4a072cab0946ce977af))
* **docs:** fix mcp installation instructions for remote servers ([298ddec](https://github.com/Finch-API/finch-api-python/commit/298ddec8fded9a72146800253d644cb96227cbde))
* ensure file data are only sent as 1 parameter ([028a805](https://github.com/Finch-API/finch-api-python/commit/028a8051485aa5ef15c6f894ac20f11ba588211c))
* **pydantic:** do not pass `by_alias` unless set ([399bc94](https://github.com/Finch-API/finch-api-python/commit/399bc94cf48e0518f87b239ead5e869d66b03fce))
* sanitize endpoint path params ([896338f](https://github.com/Finch-API/finch-api-python/commit/896338f100cb035ad2ff29d9c7f199836aafe85c))
* **tests:** skip broken date validation test ([e22eb0f](https://github.com/Finch-API/finch-api-python/commit/e22eb0ffed3e42143600c931f2ab5b342160230c))
* use correct field name format for multipart file arrays ([f952a4d](https://github.com/Finch-API/finch-api-python/commit/f952a4d765d4295cbc6474787fa67b9dfa1fd19f))


### Performance Improvements

* **client:** optimize file structure copying in multipart requests ([4c5544c](https://github.com/Finch-API/finch-api-python/commit/4c5544ca2e32e65798b720cd89f9f3a3b5c8cbc7))


### Chores

* **auth:** remove custom header handling code ([#692](https://github.com/Finch-API/finch-api-python/issues/692)) ([d64958b](https://github.com/Finch-API/finch-api-python/commit/d64958b1d3fb1ffbc25ea0d7785b838198b2fbff))
* **ci:** skip lint on metadata-only changes ([2f97b57](https://github.com/Finch-API/finch-api-python/commit/2f97b57c54b536e47a0117d22ecbe1330532028b))
* **ci:** skip uploading artifacts on stainless-internal branches ([0d13335](https://github.com/Finch-API/finch-api-python/commit/0d13335d29a546c8cc94e67b59c19835821f974e))
* **ci:** upgrade `actions/github-script` ([f342729](https://github.com/Finch-API/finch-api-python/commit/f3427295a99f7aa4a45412f699ec6b3cc41b16c2))
* format all `api.md` files ([8555964](https://github.com/Finch-API/finch-api-python/commit/8555964275d168e400ef190422baee5a1983eeb1))
* **internal:** add request options to SSE classes ([977dcfa](https://github.com/Finch-API/finch-api-python/commit/977dcfa5e7da78f0d4b465843e52a4fd2999799b))
* **internal:** bump dependencies ([0b67a64](https://github.com/Finch-API/finch-api-python/commit/0b67a64b36f6824c1000d126e5ed707e495c3c59))
* **internal:** codegen related update ([94aae5c](https://github.com/Finch-API/finch-api-python/commit/94aae5c36d464596cda9c899f64be67959fd9cb5))
* **internal:** codegen related update ([b746d12](https://github.com/Finch-API/finch-api-python/commit/b746d12f98b1fcb287bf1b7844fc8a2d864a7d86))
* **internal:** fix lint error on Python 3.14 ([b0f5ba3](https://github.com/Finch-API/finch-api-python/commit/b0f5ba3c117a989524c31e6c62ab9215f98fccd2))
* **internal:** make `test_proxy_environment_variables` more resilient ([e33584f](https://github.com/Finch-API/finch-api-python/commit/e33584fc7bc4aaaa73377f8436f9858190266236))
* **internal:** make `test_proxy_environment_variables` more resilient to env ([9f092c7](https://github.com/Finch-API/finch-api-python/commit/9f092c7d989fbe863c8d8624238694c564a871f0))
* **internal:** more robust bootstrap script ([524ba9e](https://github.com/Finch-API/finch-api-python/commit/524ba9ee8dacdeb0cb810b409d9de754df330202))
* **internal:** reformat pyproject.toml ([d713cd0](https://github.com/Finch-API/finch-api-python/commit/d713cd0cebe21fbeea5e46f075c3bd7eb9f4fbe0))
* **internal:** tweak CI branches ([9e540f1](https://github.com/Finch-API/finch-api-python/commit/9e540f1c1e03cd4099b4b7338fc689c569bd8e54))
* **internal:** update gitignore ([fd09507](https://github.com/Finch-API/finch-api-python/commit/fd09507b7fce652401ad9b70288ecd584810a91c))
* **tests:** bump steady to v0.19.4 ([bfdc74c](https://github.com/Finch-API/finch-api-python/commit/bfdc74c110317db9f811a74dffe77401972f2886))
* **tests:** bump steady to v0.19.5 ([2822044](https://github.com/Finch-API/finch-api-python/commit/2822044db38b48467ff6d82e060071833d2a4940))
* **tests:** bump steady to v0.19.6 ([b3457c1](https://github.com/Finch-API/finch-api-python/commit/b3457c13fc3dcbe72cfb4adba20f064785e54e1e))
* **tests:** bump steady to v0.19.7 ([634c5ef](https://github.com/Finch-API/finch-api-python/commit/634c5ef26def74ca00f796e01cdd1412e10e7f82))
* **tests:** bump steady to v0.20.1 ([f92438d](https://github.com/Finch-API/finch-api-python/commit/f92438d4a64c8b830068bed2ee9b6ec45a3d9562))
* **tests:** bump steady to v0.20.2 ([2abc18d](https://github.com/Finch-API/finch-api-python/commit/2abc18d84f6101550cf5d898cf5d5492f00e08fa))
* **tests:** bump steady to v0.22.1 ([78e1421](https://github.com/Finch-API/finch-api-python/commit/78e14212421f1cb9ad536fb94b4f3992800d5cee))
* update mock server docs ([7891a91](https://github.com/Finch-API/finch-api-python/commit/7891a91c042ae55b9aeaec5980b81197b8692039))


### Refactors

* **tests:** switch from prism to steady ([8ff1f27](https://github.com/Finch-API/finch-api-python/commit/8ff1f27fe2442bfdc34937c1595fd23d2db9a60d))

## 1.44.1 (2026-01-16)

Full Changelog: [v1.44.0...v1.44.1](https://github.com/Finch-API/finch-api-python/compare/v1.44.0...v1.44.1)
Expand Down
5 changes: 2 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,11 +85,10 @@ $ pip install ./path-to-wheel-file.whl

## Running tests

Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
Most tests require you to [set up a mock server](https://github.com/dgellow/steady) against the OpenAPI spec to run the tests.

```sh
# you will need npm installed
$ npx prism mock path/to/your/openapi.yml
$ ./scripts/mock
```

```sh
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ It is generated with [Stainless](https://www.stainless.com/).

Use the Finch MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40tryfinch%2Ffinch-api-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0cnlmaW5jaC9maW5jaC1hcGktbWNwIl19)
[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40tryfinch%2Ffinch-api-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tryfinch%2Ffinch-api-mcp%22%5D%7D)
[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40tryfinch%2Ffinch-api-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0cnlmaW5jaC9maW5jaC1hcGktbWNwIl0sImVudiI6eyJGSU5DSF9BQ0NFU1NfVE9LRU4iOiJNeSBBY2Nlc3MgVG9rZW4iLCJGSU5DSF9DTElFTlRfSUQiOiI0YWIxNWU1MS0xMWFkLTQ5ZjQtYWNhZS1mMzQzYjc3OTQzNzUiLCJGSU5DSF9DTElFTlRfU0VDUkVUIjoiTXkgQ2xpZW50IFNlY3JldCIsIkZJTkNIX1dFQkhPT0tfU0VDUkVUIjoiTXkgV2ViaG9vayBTZWNyZXQifX0)
[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40tryfinch%2Ffinch-api-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tryfinch%2Ffinch-api-mcp%22%5D%2C%22env%22%3A%7B%22FINCH_ACCESS_TOKEN%22%3A%22My%20Access%20Token%22%2C%22FINCH_CLIENT_ID%22%3A%224ab15e51-11ad-49f4-acae-f343b7794375%22%2C%22FINCH_CLIENT_SECRET%22%3A%22My%20Client%20Secret%22%2C%22FINCH_WEBHOOK_SECRET%22%3A%22My%20Webhook%20Secret%22%7D%7D)

> Note: You may need to set environment variables in your MCP client.

Expand Down
5 changes: 4 additions & 1 deletion api.md
Original file line number Diff line number Diff line change
Expand Up @@ -172,6 +172,7 @@ from finch.types.hris import (
BenefitsSupport,
CompanyBenefit,
CreateCompanyBenefitsResponse,
RegisterCompanyBenefitResponse,
SupportPerBenefitType,
SupportedBenefit,
UpdateCompanyBenefitResponse,
Expand All @@ -186,6 +187,7 @@ Methods:
- <code title="post /employer/benefits/{benefit_id}">client.hris.benefits.<a href="./src/finch/resources/hris/benefits/benefits.py">update</a>(benefit_id, \*\*<a href="src/finch/types/hris/benefit_update_params.py">params</a>) -> <a href="./src/finch/types/hris/update_company_benefit_response.py">UpdateCompanyBenefitResponse</a></code>
- <code title="get /employer/benefits">client.hris.benefits.<a href="./src/finch/resources/hris/benefits/benefits.py">list</a>(\*\*<a href="src/finch/types/hris/benefit_list_params.py">params</a>) -> <a href="./src/finch/types/hris/company_benefit.py">SyncSinglePage[CompanyBenefit]</a></code>
- <code title="get /employer/benefits/meta">client.hris.benefits.<a href="./src/finch/resources/hris/benefits/benefits.py">list_supported_benefits</a>(\*\*<a href="src/finch/types/hris/benefit_list_supported_benefits_params.py">params</a>) -> <a href="./src/finch/types/hris/supported_benefit.py">SyncSinglePage[SupportedBenefit]</a></code>
- <code title="post /employer/benefits/register">client.hris.benefits.<a href="./src/finch/resources/hris/benefits/benefits.py">register</a>(\*\*<a href="src/finch/types/hris/benefit_register_params.py">params</a>) -> <a href="./src/finch/types/hris/register_company_benefit_response.py">RegisterCompanyBenefitResponse</a></code>

### Individuals

Expand Down Expand Up @@ -224,12 +226,13 @@ Methods:
Types:

```python
from finch.types import DisconnectResponse, Introspection
from finch.types import DisconnectEntityResponse, DisconnectResponse, Introspection
```

Methods:

- <code title="post /disconnect">client.account.<a href="./src/finch/resources/account.py">disconnect</a>() -> <a href="./src/finch/types/disconnect_response.py">DisconnectResponse</a></code>
- <code title="post /disconnect-entity">client.account.<a href="./src/finch/resources/account.py">disconnect_entity</a>(\*\*<a href="src/finch/types/account_disconnect_entity_params.py">params</a>) -> <a href="./src/finch/types/disconnect_entity_response.py">DisconnectEntityResponse</a></code>
- <code title="get /introspect">client.account.<a href="./src/finch/resources/account.py">introspect</a>() -> <a href="./src/finch/types/introspection.py">Introspection</a></code>

# Webhooks
Expand Down
8 changes: 4 additions & 4 deletions pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "finch-api"
version = "1.44.1"
version = "1.45.0"
description = "The official Python library for the Finch API"
dynamic = ["readme"]
license = "Apache-2.0"
Expand All @@ -11,7 +11,7 @@ authors = [
dependencies = [
"httpx>=0.23.0, <1",
"pydantic>=1.9.0, <3",
"typing-extensions>=4.10, <5",
"typing-extensions>=4.14, <5",
"anyio>=3.5.0, <5",
"distro>=1.7.0, <2",
"sniffio",
Expand Down Expand Up @@ -69,7 +69,7 @@ format = { chain = [
# run formatting again to fix any inconsistencies when imports are stripped
"format:ruff",
]}
"format:docs" = "python scripts/utils/ruffen-docs.py README.md api.md"
"format:docs" = "bash -c 'python scripts/utils/ruffen-docs.py README.md $(find . -type f -name api.md)'"
"format:ruff" = "ruff format"

"lint" = { chain = [
Expand Down Expand Up @@ -168,7 +168,7 @@ show_error_codes = true
#
# We also exclude our `tests` as mypy doesn't always infer
# types correctly and Pyright will still catch any type errors.
exclude = ['src/finch/_files.py', '_dev/.*.py', 'tests/.*']
exclude = ["src/finch/_files.py", "_dev/.*.py", "tests/.*"]

strict_equality = true
implicit_reexport = true
Expand Down
Loading
Loading