snaptrade-typescript-sdk 9.0.38 → 9.0.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  Connect brokerage accounts to your app for live positions and trading
8
8
 
9
- [![npm](https://img.shields.io/badge/npm-v9.0.38-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.38)
9
+ [![npm](https://img.shields.io/badge/npm-v9.0.39-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.39)
10
10
  [![More Info](https://img.shields.io/badge/More%20Info-Click%20Here-orange)](https://snaptrade.com/)
11
11
 
12
12
  </div>
@@ -427,7 +427,7 @@ const getUserHoldingsResponse =
427
427
 
428
428
  ### `snaptrade.accountInformation.listUserAccounts`<a id="snaptradeaccountinformationlistuseraccounts"></a>
429
429
 
430
- Returns all brokerage accounts known to SnapTrade for the authenticated user.
430
+ Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user.
431
431
 
432
432
  The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
433
433
 
@@ -554,7 +554,7 @@ const deleteSnapTradeUserResponse =
554
554
 
555
555
  ### `snaptrade.authentication.listSnapTradeUsers`<a id="snaptradeauthenticationlistsnaptradeusers"></a>
556
556
 
557
- Returns a list of all registered user IDs.
557
+ Returns a list of all registered user IDs. Please note that the response is not currently paginated.
558
558
 
559
559
  #### 🛠️ Usage<a id="🛠️-usage"></a>
560
560
 
@@ -709,14 +709,14 @@ SnapTrade User Secret. This is a randomly generated string and should be stored
709
709
 
710
710
  ### `snaptrade.connections.detailBrokerageAuthorization`<a id="snaptradeconnectionsdetailbrokerageauthorization"></a>
711
711
 
712
- Returns a single brokerage authorization object for the specified ID.
712
+ Returns a single connection for the specified ID.
713
713
 
714
714
  #### 🛠️ Usage<a id="🛠️-usage"></a>
715
715
 
716
716
  ```typescript
717
717
  const detailBrokerageAuthorizationResponse =
718
718
  await snaptrade.connections.detailBrokerageAuthorization({
719
- authorizationId: "2bcd7cc3-e922-4976-bce1-9858296801c3",
719
+ authorizationId: "87b24961-b51e-4db8-9226-f198f6518a89",
720
720
  userId: "snaptrade-user-123",
721
721
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
722
722
  });
@@ -726,8 +726,6 @@ const detailBrokerageAuthorizationResponse =
726
726
 
727
727
  ##### authorizationId: `string`<a id="authorizationid-string"></a>
728
728
 
729
- The ID of a brokerage authorization object.
730
-
731
729
  ##### userId: `string`<a id="userid-string"></a>
732
730
 
733
731
  ##### userSecret: `string`<a id="usersecret-string"></a>
@@ -747,14 +745,18 @@ The ID of a brokerage authorization object.
747
745
 
748
746
  ### `snaptrade.connections.disableBrokerageAuthorization`<a id="snaptradeconnectionsdisablebrokerageauthorization"></a>
749
747
 
750
- Manually disable a connection. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a CONNECTION_BROKEN webhook for the connection. Please contact us in order to use this endpoint as it is disabled by default.
748
+ Manually force the specified connection to become disabled. This should only be used for testing a reconnect flow, and never used on production connections.
749
+ Will trigger a disconnect as if it happened naturally, and send a [`CONNECTION_BROKEN` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-connection_broken) for the connection.
750
+
751
+ *Please contact us in order to use this endpoint as it is disabled by default.*
752
+
751
753
 
752
754
  #### 🛠️ Usage<a id="🛠️-usage"></a>
753
755
 
754
756
  ```typescript
755
757
  const disableBrokerageAuthorizationResponse =
756
758
  await snaptrade.connections.disableBrokerageAuthorization({
757
- authorizationId: "2bcd7cc3-e922-4976-bce1-9858296801c3",
759
+ authorizationId: "87b24961-b51e-4db8-9226-f198f6518a89",
758
760
  userId: "snaptrade-user-123",
759
761
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
760
762
  });
@@ -764,8 +766,6 @@ const disableBrokerageAuthorizationResponse =
764
766
 
765
767
  ##### authorizationId: `string`<a id="authorizationid-string"></a>
766
768
 
767
- The ID of a brokerage authorization object.
768
-
769
769
  ##### userId: `string`<a id="userid-string"></a>
770
770
 
771
771
  ##### userSecret: `string`<a id="usersecret-string"></a>
@@ -785,7 +785,12 @@ The ID of a brokerage authorization object.
785
785
 
786
786
  ### `snaptrade.connections.listBrokerageAuthorizations`<a id="snaptradeconnectionslistbrokerageauthorizations"></a>
787
787
 
788
- Returns a list of Brokerage Authorization objects for the user
788
+ Returns a list of all connections for the specified user. Note that `Connection` and `Brokerage Authorization` are interchangeable, but the term `Connection` is preferred and used in the doc for consistency.
789
+
790
+ A connection is usually tied to a single login at a brokerage. A single connection can contain multiple brokerage accounts.
791
+
792
+ SnapTrade performs de-duping on connections for a given user. If the user has an existing connection with the brokerage, when connecting the brokerage with the same credentials, SnapTrade will return the existing connection instead of creating a new one.
793
+
789
794
 
790
795
  #### 🛠️ Usage<a id="🛠️-usage"></a>
791
796
 
@@ -818,14 +823,17 @@ const listBrokerageAuthorizationsResponse =
818
823
 
819
824
  ### `snaptrade.connections.refreshBrokerageAuthorization`<a id="snaptradeconnectionsrefreshbrokerageauthorization"></a>
820
825
 
821
- Trigger a holdings update for all accounts under this authorization. Updates will be queued asynchronously. ACCOUNT_HOLDINGS_UPDATED webhook will be sent once the sync completes. Please contact support for access as this endpoint is not enabled by default
826
+ Trigger a holdings update for all accounts under this connection. Updates will be queued asynchronously. [`ACCOUNT_HOLDINGS_UPDATED` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-account_holdings_updated) will be sent once the sync completes for each account under the connection.
827
+
828
+ *Please contact support for access as this endpoint is not enabled by default.*
829
+
822
830
 
823
831
  #### 🛠️ Usage<a id="🛠️-usage"></a>
824
832
 
825
833
  ```typescript
826
834
  const refreshBrokerageAuthorizationResponse =
827
835
  await snaptrade.connections.refreshBrokerageAuthorization({
828
- authorizationId: "2bcd7cc3-e922-4976-bce1-9858296801c3",
836
+ authorizationId: "87b24961-b51e-4db8-9226-f198f6518a89",
829
837
  userId: "snaptrade-user-123",
830
838
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
831
839
  });
@@ -835,8 +843,6 @@ const refreshBrokerageAuthorizationResponse =
835
843
 
836
844
  ##### authorizationId: `string`<a id="authorizationid-string"></a>
837
845
 
838
- The ID of a brokerage authorization object.
839
-
840
846
  ##### userId: `string`<a id="userid-string"></a>
841
847
 
842
848
  ##### userSecret: `string`<a id="usersecret-string"></a>
@@ -856,14 +862,14 @@ The ID of a brokerage authorization object.
856
862
 
857
863
  ### `snaptrade.connections.removeBrokerageAuthorization`<a id="snaptradeconnectionsremovebrokerageauthorization"></a>
858
864
 
859
- Deletes a specified brokerage authorization given by the ID.
865
+ Deletes the connection specified by the ID. This will also delete all accounts and holdings associated with the connection. This action is irreversible. This endpoint is synchronous, a 204 response indicates that the connection has been successfully deleted.
860
866
 
861
867
  #### 🛠️ Usage<a id="🛠️-usage"></a>
862
868
 
863
869
  ```typescript
864
870
  const removeBrokerageAuthorizationResponse =
865
871
  await snaptrade.connections.removeBrokerageAuthorization({
866
- authorizationId: "2bcd7cc3-e922-4976-bce1-9858296801c3",
872
+ authorizationId: "87b24961-b51e-4db8-9226-f198f6518a89",
867
873
  userId: "snaptrade-user-123",
868
874
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
869
875
  });
@@ -873,8 +879,6 @@ const removeBrokerageAuthorizationResponse =
873
879
 
874
880
  ##### authorizationId: `string`<a id="authorizationid-string"></a>
875
881
 
876
- The ID of the Authorization to delete.
877
-
878
882
  ##### userId: `string`<a id="userid-string"></a>
879
883
 
880
884
  ##### userSecret: `string`<a id="usersecret-string"></a>
@@ -76,7 +76,7 @@ export declare const AccountInformationApiAxiosParamCreator: (configuration?: Co
76
76
  */
77
77
  getUserHoldings: (accountId: string, userId: string, userSecret: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
78
78
  /**
79
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
79
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
80
80
  * @summary List accounts
81
81
  * @param {string} userId
82
82
  * @param {string} userSecret
@@ -150,7 +150,7 @@ export declare const AccountInformationApiFp: (configuration?: Configuration) =>
150
150
  */
151
151
  getUserHoldings(requestParameters: AccountInformationApiGetUserHoldingsRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AccountHoldingsAccount>>;
152
152
  /**
153
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
153
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
154
154
  * @summary List accounts
155
155
  * @param {AccountInformationApiListUserAccountsRequest} requestParameters Request parameters.
156
156
  * @param {*} [options] Override http request option.
@@ -221,7 +221,7 @@ export declare const AccountInformationApiFactory: (configuration?: Configuratio
221
221
  */
222
222
  getUserHoldings(requestParameters: AccountInformationApiGetUserHoldingsRequest, options?: AxiosRequestConfig): AxiosPromise<AccountHoldingsAccount>;
223
223
  /**
224
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
224
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
225
225
  * @summary List accounts
226
226
  * @param {AccountInformationApiListUserAccountsRequest} requestParameters Request parameters.
227
227
  * @param {*} [options] Override http request option.
@@ -506,7 +506,7 @@ export declare class AccountInformationApiGenerated extends BaseAPI {
506
506
  */
507
507
  getUserHoldings(requestParameters: AccountInformationApiGetUserHoldingsRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<AccountHoldingsAccount, any>>;
508
508
  /**
509
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
509
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
510
510
  * @summary List accounts
511
511
  * @param {AccountInformationApiListUserAccountsRequest} requestParameters Request parameters.
512
512
  * @param {*} [options] Override http request option.
@@ -375,7 +375,7 @@ const AccountInformationApiAxiosParamCreator = function (configuration) {
375
375
  };
376
376
  }),
377
377
  /**
378
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
378
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
379
379
  * @summary List accounts
380
380
  * @param {string} userId
381
381
  * @param {string} userSecret
@@ -570,7 +570,7 @@ const AccountInformationApiFp = function (configuration) {
570
570
  });
571
571
  },
572
572
  /**
573
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
573
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
574
574
  * @summary List accounts
575
575
  * @param {AccountInformationApiListUserAccountsRequest} requestParameters Request parameters.
576
576
  * @param {*} [options] Override http request option.
@@ -667,7 +667,7 @@ const AccountInformationApiFactory = function (configuration, basePath, axios) {
667
667
  return localVarFp.getUserHoldings(requestParameters, options).then((request) => request(axios, basePath));
668
668
  },
669
669
  /**
670
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
670
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
671
671
  * @summary List accounts
672
672
  * @param {AccountInformationApiListUserAccountsRequest} requestParameters Request parameters.
673
673
  * @param {*} [options] Override http request option.
@@ -764,7 +764,7 @@ class AccountInformationApiGenerated extends base_1.BaseAPI {
764
764
  return (0, exports.AccountInformationApiFp)(this.configuration).getUserHoldings(requestParameters, options).then((request) => request(this.axios, this.basePath));
765
765
  }
766
766
  /**
767
- * Returns all brokerage accounts known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
767
+ * Returns all brokerage accounts across all connections known to SnapTrade for the authenticated user. The data returned here is always cached and refreshed once a day. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
768
768
  * @summary List accounts
769
769
  * @param {AccountInformationApiListUserAccountsRequest} requestParameters Request parameters.
770
770
  * @param {*} [options] Override http request option.
@@ -20,7 +20,7 @@ export declare const AuthenticationApiAxiosParamCreator: (configuration?: Config
20
20
  */
21
21
  deleteSnapTradeUser: (userId: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
22
22
  /**
23
- * Returns a list of all registered user IDs.
23
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
24
24
  * @summary List all users
25
25
  * @param {*} [options] Override http request option.
26
26
  * @throws {RequiredError}
@@ -67,7 +67,7 @@ export declare const AuthenticationApiFp: (configuration?: Configuration) => {
67
67
  */
68
68
  deleteSnapTradeUser(requestParameters: AuthenticationApiDeleteSnapTradeUserRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<DeleteUserResponse>>;
69
69
  /**
70
- * Returns a list of all registered user IDs.
70
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
71
71
  * @summary List all users
72
72
  * @param {*} [options] Override http request option.
73
73
  * @throws {RequiredError}
@@ -112,7 +112,7 @@ export declare const AuthenticationApiFactory: (configuration?: Configuration, b
112
112
  */
113
113
  deleteSnapTradeUser(requestParameters: AuthenticationApiDeleteSnapTradeUserRequest, options?: AxiosRequestConfig): AxiosPromise<DeleteUserResponse>;
114
114
  /**
115
- * Returns a list of all registered user IDs.
115
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
116
116
  * @summary List all users
117
117
  * @param {*} [options] Override http request option.
118
118
  * @throws {RequiredError}
@@ -204,7 +204,7 @@ export declare class AuthenticationApiGenerated extends BaseAPI {
204
204
  */
205
205
  deleteSnapTradeUser(requestParameters: AuthenticationApiDeleteSnapTradeUserRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<DeleteUserResponse, any>>;
206
206
  /**
207
- * Returns a list of all registered user IDs.
207
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
208
208
  * @summary List all users
209
209
  * @param {*} [options] Override http request option.
210
210
  * @throws {RequiredError}
@@ -81,7 +81,7 @@ const AuthenticationApiAxiosParamCreator = function (configuration) {
81
81
  };
82
82
  }),
83
83
  /**
84
- * Returns a list of all registered user IDs.
84
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
85
85
  * @summary List all users
86
86
  * @param {*} [options] Override http request option.
87
87
  * @throws {RequiredError}
@@ -288,7 +288,7 @@ const AuthenticationApiFp = function (configuration) {
288
288
  });
289
289
  },
290
290
  /**
291
- * Returns a list of all registered user IDs.
291
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
292
292
  * @summary List all users
293
293
  * @param {*} [options] Override http request option.
294
294
  * @throws {RequiredError}
@@ -374,7 +374,7 @@ const AuthenticationApiFactory = function (configuration, basePath, axios) {
374
374
  return localVarFp.deleteSnapTradeUser(requestParameters, options).then((request) => request(axios, basePath));
375
375
  },
376
376
  /**
377
- * Returns a list of all registered user IDs.
377
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
378
378
  * @summary List all users
379
379
  * @param {*} [options] Override http request option.
380
380
  * @throws {RequiredError}
@@ -434,7 +434,7 @@ class AuthenticationApiGenerated extends base_1.BaseAPI {
434
434
  return (0, exports.AuthenticationApiFp)(this.configuration).deleteSnapTradeUser(requestParameters, options).then((request) => request(this.axios, this.basePath));
435
435
  }
436
436
  /**
437
- * Returns a list of all registered user IDs.
437
+ * Returns a list of all registered user IDs. Please note that the response is not currently paginated.
438
438
  * @summary List all users
439
439
  * @param {*} [options] Override http request option.
440
440
  * @throws {RequiredError}
@@ -11,9 +11,9 @@ import { ConnectionsSessionEvents200ResponseInner } from '../models';
11
11
  */
12
12
  export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configuration) => {
13
13
  /**
14
- * Returns a single brokerage authorization object for the specified ID.
15
- * @summary Get brokerage authorization details
16
- * @param {string} authorizationId The ID of a brokerage authorization object.
14
+ * Returns a single connection for the specified ID.
15
+ * @summary Get connection detail
16
+ * @param {string} authorizationId
17
17
  * @param {string} userId
18
18
  * @param {string} userSecret
19
19
  * @param {*} [options] Override http request option.
@@ -21,9 +21,9 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
21
21
  */
22
22
  detailBrokerageAuthorization: (authorizationId: string, userId: string, userSecret: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
23
23
  /**
24
- * Manually disable a connection. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a CONNECTION_BROKEN webhook for the connection. Please contact us in order to use this endpoint as it is disabled by default.
25
- * @summary Manually disable a connection for testing
26
- * @param {string} authorizationId The ID of a brokerage authorization object.
24
+ * Manually force the specified connection to become disabled. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a [`CONNECTION_BROKEN` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-connection_broken) for the connection. *Please contact us in order to use this endpoint as it is disabled by default.*
25
+ * @summary Force disable connection
26
+ * @param {string} authorizationId
27
27
  * @param {string} userId
28
28
  * @param {string} userSecret
29
29
  * @param {*} [options] Override http request option.
@@ -31,8 +31,8 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
31
31
  */
32
32
  disableBrokerageAuthorization: (authorizationId: string, userId: string, userSecret: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33
33
  /**
34
- * Returns a list of Brokerage Authorization objects for the user
35
- * @summary List all brokerage authorizations for the User
34
+ * Returns a list of all connections for the specified user. Note that `Connection` and `Brokerage Authorization` are interchangeable, but the term `Connection` is preferred and used in the doc for consistency. A connection is usually tied to a single login at a brokerage. A single connection can contain multiple brokerage accounts. SnapTrade performs de-duping on connections for a given user. If the user has an existing connection with the brokerage, when connecting the brokerage with the same credentials, SnapTrade will return the existing connection instead of creating a new one.
35
+ * @summary List all connections
36
36
  * @param {string} userId
37
37
  * @param {string} userSecret
38
38
  * @param {*} [options] Override http request option.
@@ -40,9 +40,9 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
40
40
  */
41
41
  listBrokerageAuthorizations: (userId: string, userSecret: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
42
42
  /**
43
- * Trigger a holdings update for all accounts under this authorization. Updates will be queued asynchronously. ACCOUNT_HOLDINGS_UPDATED webhook will be sent once the sync completes. Please contact support for access as this endpoint is not enabled by default
43
+ * Trigger a holdings update for all accounts under this connection. Updates will be queued asynchronously. [`ACCOUNT_HOLDINGS_UPDATED` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-account_holdings_updated) will be sent once the sync completes for each account under the connection. *Please contact support for access as this endpoint is not enabled by default.*
44
44
  * @summary Refresh holdings for a connection
45
- * @param {string} authorizationId The ID of a brokerage authorization object.
45
+ * @param {string} authorizationId
46
46
  * @param {string} userId
47
47
  * @param {string} userSecret
48
48
  * @param {*} [options] Override http request option.
@@ -50,9 +50,9 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
50
50
  */
51
51
  refreshBrokerageAuthorization: (authorizationId: string, userId: string, userSecret: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
52
52
  /**
53
- * Deletes a specified brokerage authorization given by the ID.
54
- * @summary Delete brokerage authorization
55
- * @param {string} authorizationId The ID of the Authorization to delete.
53
+ * Deletes the connection specified by the ID. This will also delete all accounts and holdings associated with the connection. This action is irreversible. This endpoint is synchronous, a 204 response indicates that the connection has been successfully deleted.
54
+ * @summary Delete connection
55
+ * @param {string} authorizationId
56
56
  * @param {string} userId
57
57
  * @param {string} userSecret
58
58
  * @param {*} [options] Override http request option.
@@ -76,31 +76,31 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
76
76
  */
77
77
  export declare const ConnectionsApiFp: (configuration?: Configuration) => {
78
78
  /**
79
- * Returns a single brokerage authorization object for the specified ID.
80
- * @summary Get brokerage authorization details
79
+ * Returns a single connection for the specified ID.
80
+ * @summary Get connection detail
81
81
  * @param {ConnectionsApiDetailBrokerageAuthorizationRequest} requestParameters Request parameters.
82
82
  * @param {*} [options] Override http request option.
83
83
  * @throws {RequiredError}
84
84
  */
85
85
  detailBrokerageAuthorization(requestParameters: ConnectionsApiDetailBrokerageAuthorizationRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BrokerageAuthorization>>;
86
86
  /**
87
- * Manually disable a connection. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a CONNECTION_BROKEN webhook for the connection. Please contact us in order to use this endpoint as it is disabled by default.
88
- * @summary Manually disable a connection for testing
87
+ * Manually force the specified connection to become disabled. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a [`CONNECTION_BROKEN` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-connection_broken) for the connection. *Please contact us in order to use this endpoint as it is disabled by default.*
88
+ * @summary Force disable connection
89
89
  * @param {ConnectionsApiDisableBrokerageAuthorizationRequest} requestParameters Request parameters.
90
90
  * @param {*} [options] Override http request option.
91
91
  * @throws {RequiredError}
92
92
  */
93
93
  disableBrokerageAuthorization(requestParameters: ConnectionsApiDisableBrokerageAuthorizationRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BrokerageAuthorizationDisabledConfirmation>>;
94
94
  /**
95
- * Returns a list of Brokerage Authorization objects for the user
96
- * @summary List all brokerage authorizations for the User
95
+ * Returns a list of all connections for the specified user. Note that `Connection` and `Brokerage Authorization` are interchangeable, but the term `Connection` is preferred and used in the doc for consistency. A connection is usually tied to a single login at a brokerage. A single connection can contain multiple brokerage accounts. SnapTrade performs de-duping on connections for a given user. If the user has an existing connection with the brokerage, when connecting the brokerage with the same credentials, SnapTrade will return the existing connection instead of creating a new one.
96
+ * @summary List all connections
97
97
  * @param {ConnectionsApiListBrokerageAuthorizationsRequest} requestParameters Request parameters.
98
98
  * @param {*} [options] Override http request option.
99
99
  * @throws {RequiredError}
100
100
  */
101
101
  listBrokerageAuthorizations(requestParameters: ConnectionsApiListBrokerageAuthorizationsRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<BrokerageAuthorization>>>;
102
102
  /**
103
- * Trigger a holdings update for all accounts under this authorization. Updates will be queued asynchronously. ACCOUNT_HOLDINGS_UPDATED webhook will be sent once the sync completes. Please contact support for access as this endpoint is not enabled by default
103
+ * Trigger a holdings update for all accounts under this connection. Updates will be queued asynchronously. [`ACCOUNT_HOLDINGS_UPDATED` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-account_holdings_updated) will be sent once the sync completes for each account under the connection. *Please contact support for access as this endpoint is not enabled by default.*
104
104
  * @summary Refresh holdings for a connection
105
105
  * @param {ConnectionsApiRefreshBrokerageAuthorizationRequest} requestParameters Request parameters.
106
106
  * @param {*} [options] Override http request option.
@@ -108,8 +108,8 @@ export declare const ConnectionsApiFp: (configuration?: Configuration) => {
108
108
  */
109
109
  refreshBrokerageAuthorization(requestParameters: ConnectionsApiRefreshBrokerageAuthorizationRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BrokerageAuthorizationRefreshConfirmation>>;
110
110
  /**
111
- * Deletes a specified brokerage authorization given by the ID.
112
- * @summary Delete brokerage authorization
111
+ * Deletes the connection specified by the ID. This will also delete all accounts and holdings associated with the connection. This action is irreversible. This endpoint is synchronous, a 204 response indicates that the connection has been successfully deleted.
112
+ * @summary Delete connection
113
113
  * @param {ConnectionsApiRemoveBrokerageAuthorizationRequest} requestParameters Request parameters.
114
114
  * @param {*} [options] Override http request option.
115
115
  * @throws {RequiredError}
@@ -130,31 +130,31 @@ export declare const ConnectionsApiFp: (configuration?: Configuration) => {
130
130
  */
131
131
  export declare const ConnectionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
132
132
  /**
133
- * Returns a single brokerage authorization object for the specified ID.
134
- * @summary Get brokerage authorization details
133
+ * Returns a single connection for the specified ID.
134
+ * @summary Get connection detail
135
135
  * @param {ConnectionsApiDetailBrokerageAuthorizationRequest} requestParameters Request parameters.
136
136
  * @param {*} [options] Override http request option.
137
137
  * @throws {RequiredError}
138
138
  */
139
139
  detailBrokerageAuthorization(requestParameters: ConnectionsApiDetailBrokerageAuthorizationRequest, options?: AxiosRequestConfig): AxiosPromise<BrokerageAuthorization>;
140
140
  /**
141
- * Manually disable a connection. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a CONNECTION_BROKEN webhook for the connection. Please contact us in order to use this endpoint as it is disabled by default.
142
- * @summary Manually disable a connection for testing
141
+ * Manually force the specified connection to become disabled. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a [`CONNECTION_BROKEN` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-connection_broken) for the connection. *Please contact us in order to use this endpoint as it is disabled by default.*
142
+ * @summary Force disable connection
143
143
  * @param {ConnectionsApiDisableBrokerageAuthorizationRequest} requestParameters Request parameters.
144
144
  * @param {*} [options] Override http request option.
145
145
  * @throws {RequiredError}
146
146
  */
147
147
  disableBrokerageAuthorization(requestParameters: ConnectionsApiDisableBrokerageAuthorizationRequest, options?: AxiosRequestConfig): AxiosPromise<BrokerageAuthorizationDisabledConfirmation>;
148
148
  /**
149
- * Returns a list of Brokerage Authorization objects for the user
150
- * @summary List all brokerage authorizations for the User
149
+ * Returns a list of all connections for the specified user. Note that `Connection` and `Brokerage Authorization` are interchangeable, but the term `Connection` is preferred and used in the doc for consistency. A connection is usually tied to a single login at a brokerage. A single connection can contain multiple brokerage accounts. SnapTrade performs de-duping on connections for a given user. If the user has an existing connection with the brokerage, when connecting the brokerage with the same credentials, SnapTrade will return the existing connection instead of creating a new one.
150
+ * @summary List all connections
151
151
  * @param {ConnectionsApiListBrokerageAuthorizationsRequest} requestParameters Request parameters.
152
152
  * @param {*} [options] Override http request option.
153
153
  * @throws {RequiredError}
154
154
  */
155
155
  listBrokerageAuthorizations(requestParameters: ConnectionsApiListBrokerageAuthorizationsRequest, options?: AxiosRequestConfig): AxiosPromise<Array<BrokerageAuthorization>>;
156
156
  /**
157
- * Trigger a holdings update for all accounts under this authorization. Updates will be queued asynchronously. ACCOUNT_HOLDINGS_UPDATED webhook will be sent once the sync completes. Please contact support for access as this endpoint is not enabled by default
157
+ * Trigger a holdings update for all accounts under this connection. Updates will be queued asynchronously. [`ACCOUNT_HOLDINGS_UPDATED` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-account_holdings_updated) will be sent once the sync completes for each account under the connection. *Please contact support for access as this endpoint is not enabled by default.*
158
158
  * @summary Refresh holdings for a connection
159
159
  * @param {ConnectionsApiRefreshBrokerageAuthorizationRequest} requestParameters Request parameters.
160
160
  * @param {*} [options] Override http request option.
@@ -162,8 +162,8 @@ export declare const ConnectionsApiFactory: (configuration?: Configuration, base
162
162
  */
163
163
  refreshBrokerageAuthorization(requestParameters: ConnectionsApiRefreshBrokerageAuthorizationRequest, options?: AxiosRequestConfig): AxiosPromise<BrokerageAuthorizationRefreshConfirmation>;
164
164
  /**
165
- * Deletes a specified brokerage authorization given by the ID.
166
- * @summary Delete brokerage authorization
165
+ * Deletes the connection specified by the ID. This will also delete all accounts and holdings associated with the connection. This action is irreversible. This endpoint is synchronous, a 204 response indicates that the connection has been successfully deleted.
166
+ * @summary Delete connection
167
167
  * @param {ConnectionsApiRemoveBrokerageAuthorizationRequest} requestParameters Request parameters.
168
168
  * @param {*} [options] Override http request option.
169
169
  * @throws {RequiredError}
@@ -185,7 +185,7 @@ export declare const ConnectionsApiFactory: (configuration?: Configuration, base
185
185
  */
186
186
  export type ConnectionsApiDetailBrokerageAuthorizationRequest = {
187
187
  /**
188
- * The ID of a brokerage authorization object.
188
+ *
189
189
  * @type {string}
190
190
  * @memberof ConnectionsApiDetailBrokerageAuthorization
191
191
  */
@@ -210,7 +210,7 @@ export type ConnectionsApiDetailBrokerageAuthorizationRequest = {
210
210
  */
211
211
  export type ConnectionsApiDisableBrokerageAuthorizationRequest = {
212
212
  /**
213
- * The ID of a brokerage authorization object.
213
+ *
214
214
  * @type {string}
215
215
  * @memberof ConnectionsApiDisableBrokerageAuthorization
216
216
  */
@@ -254,7 +254,7 @@ export type ConnectionsApiListBrokerageAuthorizationsRequest = {
254
254
  */
255
255
  export type ConnectionsApiRefreshBrokerageAuthorizationRequest = {
256
256
  /**
257
- * The ID of a brokerage authorization object.
257
+ *
258
258
  * @type {string}
259
259
  * @memberof ConnectionsApiRefreshBrokerageAuthorization
260
260
  */
@@ -279,7 +279,7 @@ export type ConnectionsApiRefreshBrokerageAuthorizationRequest = {
279
279
  */
280
280
  export type ConnectionsApiRemoveBrokerageAuthorizationRequest = {
281
281
  /**
282
- * The ID of the Authorization to delete.
282
+ *
283
283
  * @type {string}
284
284
  * @memberof ConnectionsApiRemoveBrokerageAuthorization
285
285
  */
@@ -330,8 +330,8 @@ export type ConnectionsApiSessionEventsRequest = {
330
330
  */
331
331
  export declare class ConnectionsApiGenerated extends BaseAPI {
332
332
  /**
333
- * Returns a single brokerage authorization object for the specified ID.
334
- * @summary Get brokerage authorization details
333
+ * Returns a single connection for the specified ID.
334
+ * @summary Get connection detail
335
335
  * @param {ConnectionsApiDetailBrokerageAuthorizationRequest} requestParameters Request parameters.
336
336
  * @param {*} [options] Override http request option.
337
337
  * @throws {RequiredError}
@@ -339,8 +339,8 @@ export declare class ConnectionsApiGenerated extends BaseAPI {
339
339
  */
340
340
  detailBrokerageAuthorization(requestParameters: ConnectionsApiDetailBrokerageAuthorizationRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<BrokerageAuthorization, any>>;
341
341
  /**
342
- * Manually disable a connection. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a CONNECTION_BROKEN webhook for the connection. Please contact us in order to use this endpoint as it is disabled by default.
343
- * @summary Manually disable a connection for testing
342
+ * Manually force the specified connection to become disabled. This should only be used for testing a reconnect flow, and never used on production connections. Will trigger a disconnect as if it happened naturally, and send a [`CONNECTION_BROKEN` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-connection_broken) for the connection. *Please contact us in order to use this endpoint as it is disabled by default.*
343
+ * @summary Force disable connection
344
344
  * @param {ConnectionsApiDisableBrokerageAuthorizationRequest} requestParameters Request parameters.
345
345
  * @param {*} [options] Override http request option.
346
346
  * @throws {RequiredError}
@@ -348,8 +348,8 @@ export declare class ConnectionsApiGenerated extends BaseAPI {
348
348
  */
349
349
  disableBrokerageAuthorization(requestParameters: ConnectionsApiDisableBrokerageAuthorizationRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<BrokerageAuthorizationDisabledConfirmation, any>>;
350
350
  /**
351
- * Returns a list of Brokerage Authorization objects for the user
352
- * @summary List all brokerage authorizations for the User
351
+ * Returns a list of all connections for the specified user. Note that `Connection` and `Brokerage Authorization` are interchangeable, but the term `Connection` is preferred and used in the doc for consistency. A connection is usually tied to a single login at a brokerage. A single connection can contain multiple brokerage accounts. SnapTrade performs de-duping on connections for a given user. If the user has an existing connection with the brokerage, when connecting the brokerage with the same credentials, SnapTrade will return the existing connection instead of creating a new one.
352
+ * @summary List all connections
353
353
  * @param {ConnectionsApiListBrokerageAuthorizationsRequest} requestParameters Request parameters.
354
354
  * @param {*} [options] Override http request option.
355
355
  * @throws {RequiredError}
@@ -357,7 +357,7 @@ export declare class ConnectionsApiGenerated extends BaseAPI {
357
357
  */
358
358
  listBrokerageAuthorizations(requestParameters: ConnectionsApiListBrokerageAuthorizationsRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<BrokerageAuthorization[], any>>;
359
359
  /**
360
- * Trigger a holdings update for all accounts under this authorization. Updates will be queued asynchronously. ACCOUNT_HOLDINGS_UPDATED webhook will be sent once the sync completes. Please contact support for access as this endpoint is not enabled by default
360
+ * Trigger a holdings update for all accounts under this connection. Updates will be queued asynchronously. [`ACCOUNT_HOLDINGS_UPDATED` webhook](https://docs.snaptrade.com/docs/webhooks#webhooks-account_holdings_updated) will be sent once the sync completes for each account under the connection. *Please contact support for access as this endpoint is not enabled by default.*
361
361
  * @summary Refresh holdings for a connection
362
362
  * @param {ConnectionsApiRefreshBrokerageAuthorizationRequest} requestParameters Request parameters.
363
363
  * @param {*} [options] Override http request option.
@@ -366,8 +366,8 @@ export declare class ConnectionsApiGenerated extends BaseAPI {
366
366
  */
367
367
  refreshBrokerageAuthorization(requestParameters: ConnectionsApiRefreshBrokerageAuthorizationRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<BrokerageAuthorizationRefreshConfirmation, any>>;
368
368
  /**
369
- * Deletes a specified brokerage authorization given by the ID.
370
- * @summary Delete brokerage authorization
369
+ * Deletes the connection specified by the ID. This will also delete all accounts and holdings associated with the connection. This action is irreversible. This endpoint is synchronous, a 204 response indicates that the connection has been successfully deleted.
370
+ * @summary Delete connection
371
371
  * @param {ConnectionsApiRemoveBrokerageAuthorizationRequest} requestParameters Request parameters.
372
372
  * @param {*} [options] Override http request option.
373
373
  * @throws {RequiredError}