Skip to content

Commit ffcc48a

Browse files
release: 1.34.0 (#670)
* feat(api): api update * release: 1.34.0 --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
1 parent cd5a119 commit ffcc48a

File tree

10 files changed

+138
-95
lines changed

10 files changed

+138
-95
lines changed

.release-please-manifest.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
".": "1.33.0"
2+
".": "1.34.0"
33
}

.stats.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 46
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-e8b684dbd61d1724b5e516a573a952bb6906d63840e27ebda7731a2f71061aff.yml
3-
openapi_spec_hash: 8baff9577d4e721d0494ff315da267ca
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-6d0c6a1feba5ccb895a6779cd98c2a0ae87d6394f5e98a9da51f17258c4eb297.yml
3+
openapi_spec_hash: ac3be0c8a992103e5f467fe1bcb20a81
44
config_hash: 5146b12344dae76238940989dac1e8a0

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
11
# Changelog
22

3+
## 1.34.0 (2025-08-20)
4+
5+
Full Changelog: [v1.33.0...v1.34.0](https://github.com/Finch-API/finch-api-python/compare/v1.33.0...v1.34.0)
6+
7+
### Features
8+
9+
* **api:** api update ([250dd73](https://github.com/Finch-API/finch-api-python/commit/250dd7334ae72a1e6c6b1c2e4578e796aa9a87ff))
10+
311
## 1.33.0 (2025-08-12)
412

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

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "finch-api"
3-
version = "1.33.0"
3+
version = "1.34.0"
44
description = "The official Python library for the Finch API"
55
dynamic = ["readme"]
66
license = "Apache-2.0"

src/finch/_version.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
22

33
__title__ = "finch"
4-
__version__ = "1.33.0" # x-release-please-version
4+
__version__ = "1.34.0" # x-release-please-version

src/finch/resources/access_tokens.py

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,9 @@ def with_streaming_response(self) -> AccessTokensWithStreamingResponse:
4040
def create(
4141
self,
4242
*,
43+
client_id: str,
44+
client_secret: str,
4345
code: str,
44-
client_id: str | NotGiven = NOT_GIVEN,
45-
client_secret: str | NotGiven = NOT_GIVEN,
4646
redirect_uri: str | NotGiven = NOT_GIVEN,
4747
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
4848
# The extra values given here take precedence over values defined on the client or passed to this method.
@@ -55,6 +55,14 @@ def create(
5555
Exchange the authorization code for an access token
5656
5757
Args:
58+
client_id: The client ID for your application
59+
60+
client_secret: The client secret for your application
61+
62+
code: The authorization code received from the authorization server
63+
64+
redirect_uri: The redirect URI used in the authorization request (optional)
65+
5866
extra_headers: Send extra headers
5967
6068
extra_query: Add additional query parameters to the request
@@ -118,9 +126,9 @@ def with_streaming_response(self) -> AsyncAccessTokensWithStreamingResponse:
118126
async def create(
119127
self,
120128
*,
129+
client_id: str,
130+
client_secret: str,
121131
code: str,
122-
client_id: str | NotGiven = NOT_GIVEN,
123-
client_secret: str | NotGiven = NOT_GIVEN,
124132
redirect_uri: str | NotGiven = NOT_GIVEN,
125133
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
126134
# The extra values given here take precedence over values defined on the client or passed to this method.
@@ -133,6 +141,14 @@ async def create(
133141
Exchange the authorization code for an access token
134142
135143
Args:
144+
client_id: The client ID for your application
145+
146+
client_secret: The client secret for your application
147+
148+
code: The authorization code received from the authorization server
149+
150+
redirect_uri: The redirect URI used in the authorization request (optional)
151+
136152
extra_headers: Send extra headers
137153
138154
extra_query: Add additional query parameters to the request

src/finch/types/access_token_create_params.py

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,14 @@
88

99

1010
class AccessTokenCreateParams(TypedDict, total=False):
11-
code: Required[str]
11+
client_id: Required[str]
12+
"""The client ID for your application"""
1213

13-
client_id: str
14+
client_secret: Required[str]
15+
"""The client secret for your application"""
1416

15-
client_secret: str
17+
code: Required[str]
18+
"""The authorization code received from the authorization server"""
1619

1720
redirect_uri: str
21+
"""The redirect URI used in the authorization request (optional)"""

src/finch/types/create_access_token_response.py

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -10,44 +10,44 @@
1010

1111
class CreateAccessTokenResponse(BaseModel):
1212
access_token: str
13-
"""The access token for the connection."""
13+
"""The access token for the connection"""
1414

15-
account_id: str
16-
"""
17-
[DEPRECATED] Use `connection_id` to identify the connection instead of this
18-
account ID.
19-
"""
20-
21-
client_type: Literal["production", "development", "sandbox"]
15+
client_type: Literal["development", "production", "sandbox"]
2216
"""The type of application associated with a token."""
2317

24-
company_id: str
25-
"""
26-
[DEPRECATED] Use `connection_id` to identify the connection instead of this
27-
company ID.
28-
"""
29-
3018
connection_id: str
31-
"""The Finch UUID of the connection associated with the `access_token`."""
19+
"""The Finch UUID of the connection associated with the `access_token`"""
3220

33-
connection_type: Literal["provider", "finch"]
21+
connection_type: Literal["finch", "provider"]
3422
"""The type of the connection associated with the token.
3523
3624
- `provider` - connection to an external provider
3725
- `finch` - finch-generated data.
3826
"""
3927

4028
products: List[str]
41-
"""An array of the authorized products associated with the `access_token`."""
29+
"""An array of the authorized products associated with the `access_token`"""
4230

4331
provider_id: str
44-
"""The ID of the provider associated with the `access_token`."""
32+
"""The ID of the provider associated with the `access_token`"""
33+
34+
token_type: str
35+
"""The RFC 8693 token type (Finch uses `bearer` tokens)"""
36+
37+
account_id: Optional[str] = None
38+
"""
39+
[DEPRECATED] Use `connection_id` to identify the connection instead of this
40+
account ID
41+
"""
42+
43+
company_id: Optional[str] = None
44+
"""
45+
[DEPRECATED] Use `connection_id` to identify the connection instead of this
46+
company ID
47+
"""
4548

4649
customer_id: Optional[str] = None
4750
"""
4851
The ID of your customer you provided to Finch when a connect session was created
49-
for this connection.
52+
for this connection
5053
"""
51-
52-
token_type: Optional[str] = None
53-
"""The RFC 8693 token type (Finch uses `bearer` tokens)"""

src/finch/types/introspection.py

Lines changed: 50 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,112 +1,115 @@
11
# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
22

3-
from typing import List, Optional
3+
from typing import List, Union, Optional
44
from datetime import datetime
55
from typing_extensions import Literal
66

77
from .._models import BaseModel
88
from .shared.connection_status_type import ConnectionStatusType
99

10-
__all__ = ["Introspection", "AuthenticationMethod", "AuthenticationMethodConnectionStatus", "ConnectionStatus"]
10+
__all__ = ["Introspection", "ConnectionStatus", "AuthenticationMethod", "AuthenticationMethodConnectionStatus"]
1111

1212

13-
class AuthenticationMethodConnectionStatus(BaseModel):
14-
message: Optional[str] = None
13+
class ConnectionStatus(BaseModel):
14+
status: ConnectionStatusType
1515

16-
status: Optional[ConnectionStatusType] = None
16+
last_successful_sync: Union[datetime, str, None] = None
17+
"""The datetime when the connection was last successfully synced"""
1718

19+
message: Optional[str] = None
1820

19-
class AuthenticationMethod(BaseModel):
20-
connection_status: Optional[AuthenticationMethodConnectionStatus] = None
2121

22-
products: Optional[List[str]] = None
23-
"""An array of the authorized products associated with the `access_token`."""
22+
class AuthenticationMethodConnectionStatus(BaseModel):
23+
status: ConnectionStatusType
2424

25-
type: Optional[Literal["assisted", "credential", "api_token", "api_credential", "oauth"]] = None
26-
"""The type of authentication method."""
25+
last_successful_sync: Union[datetime, str, None] = None
26+
"""The datetime when the connection was last successfully synced"""
2727

28+
message: Optional[str] = None
2829

29-
class ConnectionStatus(BaseModel):
30-
last_successful_sync: Optional[datetime] = None
31-
"""The datetime when the connection was last successfully synced."""
3230

33-
message: Optional[str] = None
31+
class AuthenticationMethod(BaseModel):
32+
type: Literal["assisted", "credential", "api_token", "api_credential", "oauth"]
33+
"""The type of authentication method"""
34+
35+
connection_status: Optional[AuthenticationMethodConnectionStatus] = None
3436

35-
status: Optional[ConnectionStatusType] = None
37+
products: Optional[List[str]] = None
38+
"""An array of the authorized products associated with the `access_token`"""
3639

3740

3841
class Introspection(BaseModel):
3942
id: str
40-
"""The Finch UUID of the token being introspected."""
41-
42-
account_id: str
43-
"""
44-
[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection
45-
instead of this account ID.
46-
"""
47-
48-
authentication_methods: List[AuthenticationMethod]
43+
"""The Finch UUID of the token being introspected"""
4944

5045
client_id: str
51-
"""The client ID of the application associated with the `access_token`."""
46+
"""The client ID of the application associated with the `access_token`"""
5247

53-
client_type: Literal["production", "development", "sandbox"]
48+
client_type: Literal["development", "production", "sandbox"]
5449
"""The type of application associated with a token."""
5550

56-
company_id: str
57-
"""
58-
[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection
59-
instead of this company ID.
60-
"""
61-
6251
connection_id: str
63-
"""The Finch UUID of the connection associated with the `access_token`."""
52+
"""The Finch UUID of the connection associated with the `access_token`"""
6453

6554
connection_status: ConnectionStatus
6655

67-
connection_type: Literal["provider", "finch"]
56+
connection_type: Literal["finch", "provider"]
6857
"""The type of the connection associated with the token.
6958
7059
- `provider` - connection to an external provider
7160
- `finch` - finch-generated data.
7261
"""
7362

63+
products: List[str]
64+
"""An array of the authorized products associated with the `access_token`."""
65+
66+
provider_id: str
67+
"""The ID of the provider associated with the `access_token`."""
68+
69+
account_id: Optional[str] = None
70+
"""
71+
[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection
72+
instead of this account ID
73+
"""
74+
75+
authentication_methods: Optional[List[AuthenticationMethod]] = None
76+
77+
company_id: Optional[str] = None
78+
"""
79+
[DEPRECATED] Use `connection_id` to associate tokens with a Finch connection
80+
instead of this company ID
81+
"""
82+
7483
customer_email: Optional[str] = None
7584
"""
7685
The email of your customer you provided to Finch when a connect session was
77-
created for this connection.
86+
created for this connection
7887
"""
7988

8089
customer_id: Optional[str] = None
8190
"""
8291
The ID of your customer you provided to Finch when a connect session was created
83-
for this connection.
92+
for this connection
8493
"""
8594

8695
customer_name: Optional[str] = None
8796
"""
8897
The name of your customer you provided to Finch when a connect session was
89-
created for this connection.
98+
created for this connection
9099
"""
91100

92-
manual: bool
101+
manual: Optional[bool] = None
93102
"""
94103
Whether the connection associated with the `access_token` uses the Assisted
95104
Connect Flow. (`true` if using Assisted Connect, `false` if connection is
96105
automated)
97106
"""
98107

99-
payroll_provider_id: str
108+
payroll_provider_id: Optional[str] = None
100109
"""
101110
[DEPRECATED] Use `provider_id` to identify the provider instead of this payroll
102111
provider ID.
103112
"""
104113

105-
products: List[str]
106-
"""An array of the authorized products associated with the `access_token`."""
107-
108-
provider_id: str
109-
"""The ID of the provider associated with the `access_token`."""
110-
111-
username: str
114+
username: Optional[str] = None
112115
"""The account username used for login associated with the `access_token`."""

0 commit comments

Comments
 (0)