@airweave/sdk 0.1.45 → 0.1.46

package/reference.md

@@ -2,7 +2,7 @@
 
 ## Sources
 
-<details><summary><code>client.sources.<a href="/src/api/resources/sources/client/Client.ts">readSource</a>(shortName) -> AirweaveSDK.SourceWithAuthenticationFields</code></summary>
+<details><summary><code>client.sources.<a href="/src/api/resources/sources/client/Client.ts">readSource</a>(shortName) -> AirweaveSDK.Source</code></summary>
 <dl>
 <dd>
 
@@ -14,17 +14,7 @@
 <dl>
 <dd>
 
-Get source by id.
-
-## Args:
-
-    db (AsyncSession): The database session.
-    short_name (str): The short name of the source.
-    user (schemas.User): The current user.
-
-## Returns:
-
-    schemas.Source: The source object.
+Get detailed information about a specific data source connector.
 
 </dd>
 </dl>
@@ -56,7 +46,7 @@ await client.sources.readSource("short_name");
 <dl>
 <dd>
 
-**shortName:** `string`
+**shortName:** `string` — Technical identifier of the source type (e.g., 'github', 'stripe', 'slack')
 
 </dd>
 </dl>
@@ -87,16 +77,10 @@ await client.sources.readSource("short_name");
 <dl>
 <dd>
 
-Get all sources for the current user.
-
-## Args:
-
-    db: The database session
-    user: The current user
+List all available data source connectors.
 
-## Returns:
-
-    list[schemas.Source]: The list of sources.
+<br/><br/>
+Returns the complete catalog of source types that Airweave can connect to.
 
 </dd>
 </dl>
@@ -153,7 +137,7 @@ await client.sources.readSources();
 <dl>
 <dd>
 
-List all collections for the current user's organization.
+List all collections that belong to your organization.
 
 </dd>
 </dl>
@@ -218,6 +202,10 @@ await client.collections.listCollections();
 
 Create a new collection.
 
+<br/><br/>
+The newly created collection is initially empty and does not contain any data
+until you explicitly add source connections to it.
+
 </dd>
 </dl>
 </dd>
@@ -233,7 +221,8 @@ Create a new collection.
 
 ```typescript
 await client.collections.createCollection({
-    name: "name",
+    name: "Finance Data",
+    readable_id: "finance-data-reports",
 });
 ```
 
@@ -281,7 +270,7 @@ await client.collections.createCollection({
 <dl>
 <dd>
 
-Get a specific collection by its readable ID.
+Retrieve a specific collection by its readable ID.
 
 </dd>
 </dl>
@@ -313,7 +302,7 @@ await client.collections.getCollection("readable_id");
 <dl>
 <dd>
 
-**readableId:** `string`
+**readableId:** `string` — The unique readable identifier of the collection (e.g., 'finance-data-ab123')
 
 </dd>
 </dl>
@@ -332,7 +321,7 @@ await client.collections.getCollection("readable_id");
 </dl>
 </details>
 
-<details><summary><code>client.collections.<a href="/src/api/resources/collections/client/Client.ts">deleteCollection</a>(readableId, { ...params }) -> AirweaveSDK.Collection</code></summary>
+<details><summary><code>client.collections.<a href="/src/api/resources/collections/client/Client.ts">updateCollection</a>(readableId, { ...params }) -> AirweaveSDK.Collection</code></summary>
 <dl>
 <dd>
 
@@ -344,16 +333,91 @@ await client.collections.getCollection("readable_id");
 <dl>
 <dd>
 
-Delete a collection by its readable ID.
+Update a collection's properties.
+
+<br/><br/>
+Modifies the display name of an existing collection.
+Note that the readable ID cannot be changed after creation to maintain stable
+API endpoints and preserve any existing integrations or bookmarks.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.collections.updateCollection("readable_id", {
+    name: "Updated Finance Data",
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
 
-Args:
-readable_id: The readable ID of the collection to delete
-delete_data: Whether to delete the data in destinations
-db: The database session
-current_user: The current user
+#### ⚙️ Parameters
 
-Returns:
-The deleted collection
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**readableId:** `string` — The unique readable identifier of the collection to update
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AirweaveSDK.CollectionUpdate`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Collections.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.collections.<a href="/src/api/resources/collections/client/Client.ts">deleteCollection</a>(readableId, { ...params }) -> AirweaveSDK.Collection</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Delete a collection and optionally its associated data.
+
+<br/><br/>
+Permanently removes a collection from your organization. By default, this only
+deletes the collection metadata while preserving the actual data in the
+destination systems.<br/><br/>All source connections within this collection
+will also be deleted as part of the cleanup process.
 
 </dd>
 </dl>
@@ -385,7 +449,7 @@ await client.collections.deleteCollection("readable_id");
 <dl>
 <dd>
 
-**readableId:** `string`
+**readableId:** `string` — The unique readable identifier of the collection to delete
 
 </dd>
 </dl>
@@ -424,17 +488,7 @@ await client.collections.deleteCollection("readable_id");
 <dl>
 <dd>
 
-Search within a collection identified by readable ID.
-
-Args:
-readable_id: The readable ID of the collection to search
-query: The search query
-response_type: Type of response (raw results or AI completion)
-db: The database session
-current_user: The current user
-
-Returns:
-dict: Search results or AI completion response
+Search across all data sources within the specified collection.
 
 </dd>
 </dl>
@@ -451,7 +505,7 @@ dict: Search results or AI completion response
 
 ```typescript
 await client.collections.searchCollection("readable_id", {
-    query: "query",
+    query: "customer payment issues",
 });
 ```
 
@@ -468,7 +522,7 @@ await client.collections.searchCollection("readable_id", {
 <dl>
 <dd>
 
-**readableId:** `string`
+**readableId:** `string` — The unique readable identifier of the collection to search
 
 </dd>
 </dl>
@@ -507,16 +561,12 @@ await client.collections.searchCollection("readable_id", {
 <dl>
 <dd>
 
-Start sync jobs for all source connections in the collection.
-
-Args:
-readable_id: The readable ID of the collection
-db: The database session
-current_user: The current user
-background_tasks: Background tasks for async operations
+Trigger data synchronization for all source connections in the collection.
 
-Returns:
-A list of created sync jobs
+<br/><br/>The sync jobs run asynchronously in the background, so this endpoint
+returns immediately with job details that you can use to track progress. You can
+monitor the status of individual data synchronization using the source connection
+endpoints.
 
 </dd>
 </dl>
@@ -548,7 +598,7 @@ await client.collections.refreshAllSourceConnections("readable_id");
 <dl>
 <dd>
 
-**readableId:** `string`
+**readableId:** `string` — The unique readable identifier of the collection to refresh
 
 </dd>
 </dl>
@@ -581,17 +631,13 @@ await client.collections.refreshAllSourceConnections("readable_id");
 <dl>
 <dd>
 
-List all source connections for the current user.
+List source connections across your organization.
 
-Args:
-db: The database session
-collection: The collection to filter by
-skip: The number of connections to skip
-limit: The number of connections to return
-user: The current user
-
-Returns:
-A list of source connection list items with essential information
+<br/><br/>
+By default, returns ALL source connections from every collection in your
+organization. Use the 'collection' parameter to filter results to a specific
+collection. This is useful for getting an overview of all your data sources
+or managing connections within a particular collection.
 
 </dd>
 </dl>
@@ -654,24 +700,21 @@ await client.sourceConnections.listSourceConnections();
 <dl>
 <dd>
 
-Create a new source connection.
+Create a new source connection to sync data into your collection.
 
-This endpoint creates:
+<br/><br/>
 
-1. An integration credential with the provided auth fields
-2. A collection if not provided
-3. The source connection
-4. A sync configuration and DAG
-5. A sync job if immediate execution is requested
+**This endpoint only works for sources that do not use OAuth2.0.**
+Sources that do use OAuth2.0 like Google Drive, Slack, or HubSpot must be
+connected through the UI where you can complete the OAuth consent flow.<br/><br/>
 
-Args:
-db: The database session
-source_connection_in: The source connection to create
-user: The current user
-background_tasks: Background tasks for async operations
+Credentials for a source have to be provided using the `auth_fields` field.
+Currently, it is not automatically checked if the provided credentials are valid.
+If they are not valid, the data synchronization will fail.<br/><br/>
 
-Returns:
-The created source connection
+Check the documentation of a specific source (for example
+[Github](https://docs.airweave.ai/docs/connectors/github)) to see what kind
+of authentication is used.
 
 </dd>
 </dl>
@@ -688,8 +731,8 @@ The created source connection
 
 ```typescript
 await client.sourceConnections.createSourceConnection({
-    name: "name",
-    shortName: "short_name",
+    name: "Production Stripe Account",
+    short_name: "stripe",
 });
 ```
 
@@ -737,16 +780,7 @@ await client.sourceConnections.createSourceConnection({
 <dl>
 <dd>
 
-Get a specific source connection by ID.
-
-Args:
-db: The database session
-source_connection_id: The ID of the source connection
-show_auth_fields: Whether to show the auth fields, default is False
-user: The current user
-
-Returns:
-The source connection
+Retrieve a specific source connection by its ID.
 
 </dd>
 </dl>
@@ -778,7 +812,7 @@ await client.sourceConnections.getSourceConnection("source_connection_id");
 <dl>
 <dd>
 
-**sourceConnectionId:** `string`
+**sourceConnectionId:** `string` — The unique identifier of the source connection
 
 </dd>
 </dl>
@@ -817,16 +851,12 @@ await client.sourceConnections.getSourceConnection("source_connection_id");
 <dl>
 <dd>
 
-Update a source connection.
+Update a source connection's properties.
 
-Args:
-db: The database session
-source_connection_id: The ID of the source connection to update
-source_connection_in: The updated source connection data
-user: The current user
+<br/><br/>
 
-Returns:
-The updated source connection
+Modify the configuration of an existing source connection including its name,
+authentication credentials, configuration fields, sync schedule, or source-specific settings.
 
 </dd>
 </dl>
@@ -858,7 +888,7 @@ await client.sourceConnections.updateSourceConnection("source_connection_id");
 <dl>
 <dd>
 
-**sourceConnectionId:** `string`
+**sourceConnectionId:** `string` — The unique identifier of the source connection to update
 
 </dd>
 </dl>
@@ -897,16 +927,13 @@ await client.sourceConnections.updateSourceConnection("source_connection_id");
 <dl>
 <dd>
 
-Delete a source connection and all related components.
+Delete a source connection.
 
-Args:
-db: The database session
-source_connection_id: The ID of the source connection to delete
-delete_data: Whether to delete the associated data in destinations
-user: The current user
+<br/><br/>
 
-Returns:
-The deleted source connection
+Permanently removes the source connection configuration and credentials.
+By default, previously synced data remains in your destination systems for continuity.
+Use delete_data=true to also remove all associated data from destination systems.
 
 </dd>
 </dl>
@@ -938,7 +965,7 @@ await client.sourceConnections.deleteSourceConnection("source_connection_id");
 <dl>
 <dd>
 
-**sourceConnectionId:** `string`
+**sourceConnectionId:** `string` — The unique identifier of the source connection to delete
 
 </dd>
 </dl>
@@ -965,7 +992,7 @@ await client.sourceConnections.deleteSourceConnection("source_connection_id");
 </dl>
 </details>
 
-<details><summary><code>client.sourceConnections.<a href="/src/api/resources/sourceConnections/client/Client.ts">runSourceConnection</a>(sourceConnectionId) -> AirweaveSDK.SourceConnectionJob</code></summary>
+<details><summary><code>client.sourceConnections.<a href="/src/api/resources/sourceConnections/client/Client.ts">runSourceConnection</a>(sourceConnectionId, { ...params }) -> AirweaveSDK.SourceConnectionJob</code></summary>
 <dl>
 <dd>
 
@@ -977,16 +1004,12 @@ await client.sourceConnections.deleteSourceConnection("source_connection_id");
 <dl>
 <dd>
 
-Trigger a sync run for a source connection.
+Manually trigger a data sync for this source connection.
 
-Args:
-db: The database session
-source_connection_id: The ID of the source connection to run
-user: The current user
-background_tasks: Background tasks for async operations
-
-Returns:
-The created sync job
+<br/><br/>
+Starts an immediate synchronization job that extracts fresh data from your source,
+transforms it according to your configuration, and updates the destination systems.
+The job runs asynchronously and endpoint returns immediately with tracking information.
 
 </dd>
 </dl>
@@ -1018,7 +1041,15 @@ await client.sourceConnections.runSourceConnection("source_connection_id");
 <dl>
 <dd>
 
-**sourceConnectionId:** `string`
+**sourceConnectionId:** `string` — The unique identifier of the source connection to sync
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AirweaveSDK.BodyRunSourceConnectionSourceConnectionsSourceConnectionIdRunPost`
 
 </dd>
 </dl>
@@ -1051,13 +1082,9 @@ await client.sourceConnections.runSourceConnection("source_connection_id");
 
 List all sync jobs for a source connection.
 
-Args:
-db: The database session
-source_connection_id: The ID of the source connection
-user: The current user
-
-Returns:
-A list of sync jobs
+<br/><br/>
+Returns the complete history of data synchronization jobs including successful syncs,
+failed attempts, and currently running operations.
 
 </dd>
 </dl>
@@ -1089,7 +1116,7 @@ await client.sourceConnections.listSourceConnectionJobs("source_connection_id");
 <dl>
 <dd>
 
-**sourceConnectionId:** `string`
+**sourceConnectionId:** `string` — The unique identifier of the source connection
 
 </dd>
 </dl>
@@ -1108,9 +1135,78 @@ await client.sourceConnections.listSourceConnectionJobs("source_connection_id");
 </dl>
 </details>
 
-## WhiteLabels
+<details><summary><code>client.sourceConnections.<a href="/src/api/resources/sourceConnections/client/Client.ts">getSourceConnectionJob</a>(sourceConnectionId, jobId) -> AirweaveSDK.SourceConnectionJob</code></summary>
+<dl>
+<dd>
 
-<details><summary><code>client.whiteLabels.<a href="/src/api/resources/whiteLabels/client/Client.ts">listWhiteLabels</a>() -> AirweaveSDK.WhiteLabel[]</code></summary>
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get detailed information about a specific sync job.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sourceConnections.getSourceConnectionJob("source_connection_id", "job_id");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**sourceConnectionId:** `string` — The unique identifier of the source connection
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**jobId:** `string` — The unique identifier of the sync job
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SourceConnections.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sourceConnections.<a href="/src/api/resources/sourceConnections/client/Client.ts">cancelSourceConnectionJob</a>(sourceConnectionId, jobId) -> AirweaveSDK.SourceConnectionJob</code></summary>
 <dl>
 <dd>
 
@@ -1122,16 +1218,92 @@ await client.sourceConnections.listSourceConnectionJobs("source_connection_id");
 <dl>
 <dd>
 
-List all white labels for the current user's organization.
+Cancel a running sync job.
+
+<br/><br/>
+Sends a cancellation signal to stop an in-progress data synchronization.
+The job will complete its current operation and then terminate gracefully.
+Only jobs in 'created', 'pending', or 'in_progress' states can be cancelled.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sourceConnections.cancelSourceConnectionJob("source_connection_id", "job_id");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**sourceConnectionId:** `string` — The unique identifier of the source connection
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**jobId:** `string` — The unique identifier of the sync job to cancel
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SourceConnections.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+## WhiteLabels
+
+<details><summary><code>client.whiteLabels.<a href="/src/api/resources/whiteLabels/client/Client.ts">listWhiteLabels</a>() -> AirweaveSDK.WhiteLabel[]</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
 
-## Args:
+<dl>
+<dd>
 
-    db: The database session
-    current_user: The current user
+<dl>
+<dd>
 
-## Returns:
+List all white label integrations for your organization.
 
-    list[schemas.WhiteLabel]: A list of white labels
+<br/><br/>
+Returns all custom OAuth integrations configured with your own branding and
+credentials. These integrations allow you to present OAuth consent screens with
+your company name instead of Airweave.<br/><br/>**White label integrations only
+work with OAuth2.0 sources** like Slack, Google Drive, or HubSpot that require
+OAuth consent flows.
 
 </dd>
 </dl>
@@ -1186,17 +1358,15 @@ await client.whiteLabels.listWhiteLabels();
 <dl>
 <dd>
 
-Create new white label integration.
-
-## Args:
+Create a new white label integration.
 
-    db: The database session
-    current_user: The current user
-    white_label_in: The white label to create
-
-## Returns:
-
-    white_label (schemas.WhiteLabel): The created white label
+<br/><br/>
+**This only works for sources that use OAuth2.0 authentication** like Slack,
+Google Drive, GitHub, or HubSpot.<br/><br/>Sets up a custom OAuth integration
+using your own OAuth application credentials and branding. Once created,
+customers will see your company name during OAuth consent flows instead of
+Airweave. This requires you to have already configured your own OAuth
+application with the target service provider.
 
 </dd>
 </dl>
@@ -1213,11 +1383,12 @@ Create new white label integration.
 
 ```typescript
 await client.whiteLabels.createWhiteLabel({
-    name: "name",
-    sourceShortName: "source_short_name",
-    redirectUrl: "redirect_url",
-    clientId: "client_id",
-    clientSecret: "client_secret",
+    name: "Customer Portal Slack Integration",
+    source_short_name: "slack",
+    redirect_url: "https://yourapp.com/auth/slack/callback",
+    client_id: "1234567890.1234567890123",
+    client_secret: "abcdefghijklmnopqrstuvwxyz123456",
+    allowed_origins: "https://yourapp.com,https://app.yourapp.com",
 });
 ```
 
@@ -1265,17 +1436,7 @@ await client.whiteLabels.createWhiteLabel({
 <dl>
 <dd>
 
-Get a specific white label integration.
-
-## Args:
-
-    db: The database session
-    white_label_id: The ID of the white label to get
-    current_user: The current user
-
-## Returns:
-
-    white_label (schemas.WhiteLabel): The white label
+Retrieve a specific white label integration by its ID.
 
 </dd>
 </dl>
@@ -1307,7 +1468,7 @@ await client.whiteLabels.getWhiteLabel("white_label_id");
 <dl>
 <dd>
 
-**whiteLabelId:** `string`
+**whiteLabelId:** `string` — The unique identifier of the white label integration
 
 </dd>
 </dl>
@@ -1338,18 +1499,7 @@ await client.whiteLabels.getWhiteLabel("white_label_id");
 <dl>
 <dd>
 
-Update a white label integration.
-
-## Args:
-
-    db: The database session
-    current_user: The current user
-    white_label_id: The ID of the white label to update
-    white_label_in: The white label to update
-
-## Returns:
-
-    white_label (schemas.WhiteLabel): The updated white label
+Update a white label integration's configuration.
 
 </dd>
 </dl>
@@ -1365,7 +1515,11 @@ Update a white label integration.
 <dd>
 
 ```typescript
-await client.whiteLabels.updateWhiteLabel("white_label_id");
+await client.whiteLabels.updateWhiteLabel("white_label_id", {
+    name: "Updated Customer Portal Integration",
+    redirect_url: "https://v2.yourapp.com/auth/slack/callback",
+    allowed_origins: "https://v2.yourapp.com,https://api.yourapp.com",
+});
 ```
 
 </dd>
@@ -1381,7 +1535,7 @@ await client.whiteLabels.updateWhiteLabel("white_label_id");
 <dl>
 <dd>
 
-**whiteLabelId:** `string`
+**whiteLabelId:** `string` — The unique identifier of the white label integration to update
 
 </dd>
 </dl>
@@ -1422,15 +1576,78 @@ await client.whiteLabels.updateWhiteLabel("white_label_id");
 
 Delete a white label integration.
 
-## Args:
+<br/><br/>
+Permanently removes the white label configuration and OAuth credentials.
+Existing source connections created through this integration will continue to work,
+but no new OAuth flows can be initiated until a new white label integration is created.
 
-    db: The database session
-    current_user: The current user
-    white_label_id: The ID of the white label to delete
+</dd>
+</dl>
+</dd>
+</dl>
 
-## Returns:
+#### 🔌 Usage
 
-    white_label (schemas.WhiteLabel): The deleted white label
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.whiteLabels.deleteWhiteLabel("white_label_id");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**whiteLabelId:** `string` — The unique identifier of the white label integration to delete
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `WhiteLabels.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.whiteLabels.<a href="/src/api/resources/whiteLabels/client/Client.ts">getWhiteLabelOauth2AuthUrl</a>(whiteLabelId) -> string</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Generate a branded OAuth2 authorization URL for customer authentication.
+
+<br/><br/>
+Creates the OAuth consent URL that customers should be redirected to for
+authentication. The OAuth consent screen will display your company name and
+branding instead of Airweave.
 
 </dd>
 </dl>
@@ -1446,7 +1663,7 @@ Delete a white label integration.
 <dd>
 
 ```typescript
-await client.whiteLabels.deleteWhiteLabel("white_label_id");
+await client.whiteLabels.getWhiteLabelOauth2AuthUrl("white_label_id");
 ```
 
 </dd>
@@ -1462,7 +1679,7 @@ await client.whiteLabels.deleteWhiteLabel("white_label_id");
 <dl>
 <dd>
 
-**whiteLabelId:** `string`
+**whiteLabelId:** `string` — The unique identifier of the white label integration
 
 </dd>
 </dl>
@@ -1481,7 +1698,7 @@ await client.whiteLabels.deleteWhiteLabel("white_label_id");
 </dl>
 </details>
 
-<details><summary><code>client.whiteLabels.<a href="/src/api/resources/whiteLabels/client/Client.ts">listWhiteLabelSyncs</a>(whiteLabelId) -> AirweaveSDK.Sync[]</code></summary>
+<details><summary><code>client.whiteLabels.<a href="/src/api/resources/whiteLabels/client/Client.ts">listWhiteLabelSourceConnections</a>(whiteLabelId) -> AirweaveSDK.SourceConnectionListItem[]</code></summary>
 <dl>
 <dd>
 
@@ -1493,17 +1710,80 @@ await client.whiteLabels.deleteWhiteLabel("white_label_id");
 <dl>
 <dd>
 
-List all syncs for a specific white label.
+List all source connections created through a specific white label integration.
+
+<br/><br/>
+Returns source connections that were established using this white label's OAuth flow.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.whiteLabels.listWhiteLabelSourceConnections("white_label_id");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**whiteLabelId:** `string` — The unique identifier of the white label integration
 
-## Args:
+</dd>
+</dl>
 
-    white_label_id: The ID of the white label to list syncs for
-    db: The database session
-    current_user: The current user
+<dl>
+<dd>
 
-## Returns:
+**requestOptions:** `WhiteLabels.RequestOptions`
 
-    list[schemas.Sync]: A list of syncs
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.whiteLabels.<a href="/src/api/resources/whiteLabels/client/Client.ts">exchangeWhiteLabelOauth2Code</a>(whiteLabelId, { ...params }) -> AirweaveSDK.SourceConnection</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Complete the OAuth flow and create a source connection.
+
+<br/><br/>
+**This is the core endpoint that converts OAuth authorization codes into working
+source connections.**<br/><br/>The OAuth credentials are obtained automatically
+from the authorization code - you do not need to provide auth_fields. The white
+label integration is automatically linked to the created source connection for
+tracking and branding purposes.
 
 </dd>
 </dl>
@@ -1519,7 +1799,9 @@ List all syncs for a specific white label.
 <dd>
 
 ```typescript
-await client.whiteLabels.listWhiteLabelSyncs("white_label_id");
+await client.whiteLabels.exchangeWhiteLabelOauth2Code("white_label_id", {
+    code: "4/P7q7W91a-oMsCeLvIaQm6bTrgtp7",
+});
 ```
 
 </dd>
@@ -1535,7 +1817,15 @@ await client.whiteLabels.listWhiteLabelSyncs("white_label_id");
 <dl>
 <dd>
 
-**whiteLabelId:** `string`
+**whiteLabelId:** `string` — The unique identifier of the white label integration
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `AirweaveSDK.BodyExchangeWhiteLabelOauth2CodeWhiteLabelsWhiteLabelIdOauth2CodePost`
 
 </dd>
 </dl>