@zapier/zapier-sdk 0.36.0 → 0.38.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.38.0
+
+### Minor Changes
+
+- 2906101: Default `listConnections` and `listTables` to only return your own items. Gate shared access and table deletion behind boolean flags: `canIncludeSharedConnections`, `canIncludeSharedTables`, `canDeleteTables`. Set via SDK options, `.zapierrc`, CLI flags (`--can-delete-tables`), or env vars (`ZAPIER_CAN_DELETE_TABLES=true`).
+
+## 0.37.0
+
+### Minor Changes
+
+- 307aa98: Add named connections support. A new `connection` parameter on `runAction`, the apps proxy, and `fetch` resolves a connection alias (string) from a connections map, or accepts a numeric `connectionId` directly. The map is provided via the `connections` field in `.zapierrc` (or the inline `manifest` option on `createZapierSdk()`).
+
 ## 0.36.0
 
 ### Minor Changes

package/CLAUDE.md

@@ -237,6 +237,56 @@ Run `add` again when:
 - An app has been updated and you want the latest fields
 - You've deleted your generated types
 
+## Named Connections
+
+Named connections let you decouple workflow code from specific connection IDs. An external system (like an execution engine) provides the mapping via `.zapierrc`, and the workflow code references connections by name.
+
+### Providing the Mapping
+
+Connections are configured in `.zapierrc` alongside app version pins, or inline via the `manifest` option:
+
+```typescript
+const zapier = createZapierSdk({
+  manifest: {
+    apps: { slack: { implementationName: "SlackCLIAPI", version: "1.21.1" } },
+    connections: {
+      slack_work: { connectionId: 12345 },
+      google_sheets: { connectionId: 67890 },
+    },
+  },
+});
+```
+
+### Using Named Connections
+
+```typescript
+// Per-call with alias
+await zapier.apps.slack.read.channels({ connection: "slack_work" });
+
+// Factory binding
+const slack = zapier.apps.slack({ connection: "slack_work" });
+await slack.read.channels({});
+
+// Lower-level API
+await zapier.runAction({
+  appKey: "slack",
+  actionType: "read",
+  actionKey: "channels",
+  connection: "slack_work",
+});
+
+// Direct connectionId also works
+await zapier.apps.slack.read.channels({ connection: 12345 });
+```
+
+### Resolution Precedence
+
+For `connectionId`: explicit `connectionId` > `connection` alias lookup (strings) or direct use (numbers) > factory binding > deprecated `authenticationId`.
+
+App version is always resolved from the `.zapierrc` manifest, not from connections.
+
+`connectionId` and `connection` are mutually exclusive in the same call.
+
 ## Error Handling
 
 ### Debugging

package/README.md

@@ -320,14 +320,72 @@ console.log(emojiData.emoji);
 
 The `createZapierSdk(...)` factory function is the main entry point for the SDK. It provides methods for managing connections, listing apps, running actions, and more.
 
-| Name                     | Type                       | Required | Default | Possible Values | Description                                                                                                                                                                                   |
-| ------------------------ | -------------------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `credentials`            | `string, object, function` | ❌       | —       | —               | Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those. |
-| `debug`                  | `boolean`                  | ❌       | —       | —               | Enable debug logging.                                                                                                                                                                         |
-| `baseUrl`                | `string`                   | ❌       | —       | —               | Base URL for Zapier API endpoints.                                                                                                                                                            |
-| `trackingBaseUrl`        | `string`                   | ❌       | —       | —               | Base URL for Zapier tracking endpoints.                                                                                                                                                       |
-| `maxNetworkRetries`      | `number`                   | ❌       | —       | —               | Max retries for rate-limited requests (default: 3).                                                                                                                                           |
-| `maxNetworkRetryDelayMs` | `number`                   | ❌       | —       | —               | Max delay in ms to wait for retry (default: 60000).                                                                                                                                           |
+| Name                          | Type                       | Required | Default | Possible Values | Description                                                                                                                                                                                   |
+| ----------------------------- | -------------------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `credentials`                 | `string, object, function` | ❌       | —       | —               | Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those. |
+| `debug`                       | `boolean`                  | ❌       | —       | —               | Enable debug logging.                                                                                                                                                                         |
+| `baseUrl`                     | `string`                   | ❌       | —       | —               | Base URL for Zapier API endpoints.                                                                                                                                                            |
+| `trackingBaseUrl`             | `string`                   | ❌       | —       | —               | Base URL for Zapier tracking endpoints.                                                                                                                                                       |
+| `maxNetworkRetries`           | `number`                   | ❌       | —       | —               | Max retries for rate-limited requests (default: 3).                                                                                                                                           |
+| `maxNetworkRetryDelayMs`      | `number`                   | ❌       | —       | —               | Max delay in ms to wait for retry (default: 60000).                                                                                                                                           |
+| `canIncludeSharedConnections` | `boolean`                  | ❌       | —       | —               | Allow listing shared connections.                                                                                                                                                             |
+| `canIncludeSharedTables`      | `boolean`                  | ❌       | —       | —               | Allow listing shared tables.                                                                                                                                                                  |
+| `canDeleteTables`             | `boolean`                  | ❌       | —       | —               | Allow deleting tables.                                                                                                                                                                        |
+
+## Named Connections
+
+Named connections let you decouple workflow code from specific connection IDs. Instead of hardcoding a `connectionId`, you reference a connection by name and the SDK resolves it from a mapping.
+
+This is useful when an execution engine or deployment system manages which connections a workflow should use.
+
+### Providing the mapping
+
+Connections are configured in `.zapierrc` alongside app version pins, or inline via the `manifest` option:
+
+```typescript
+const zapier = createZapierSdk({
+  manifest: {
+    apps: { slack: { implementationName: "SlackCLIAPI", version: "1.21.1" } },
+    connections: {
+      slack_work: { connectionId: 12345 },
+      google_sheets: { connectionId: 67890 },
+    },
+  },
+});
+```
+
+Each connection entry maps a name to a `connectionId`. App version resolution is handled separately via the `apps` section of `.zapierrc`.
+
+### Using named connections
+
+Reference connections by alias using the `connection` parameter. String values are resolved from the connections map; numeric values are used directly as a `connectionId`.
+
+```typescript
+// Per-call with alias
+await zapier.apps.slack.read.channels({ connection: "slack_work" });
+
+// Factory binding
+const slack = zapier.apps.slack({ connection: "slack_work" });
+await slack.read.channels({});
+
+// Lower-level runAction
+await zapier.runAction({
+  appKey: "slack",
+  actionType: "read",
+  actionKey: "channels",
+  connection: "slack_work",
+});
+
+// Authenticated fetch
+await zapier.fetch("https://slack.com/api/auth.test", {
+  connection: "slack_work",
+});
+
+// Direct connectionId also works
+await zapier.apps.slack.read.channels({ connection: 12345 });
+```
+
+`connection` and `connectionId` are mutually exclusive in the same call. You can still use `connectionId` directly if you prefer.
 
 ## Available Functions
 
@@ -561,18 +619,19 @@ Execute an action with the given inputs
 
 **Parameters:**
 
-| Name             | Type             | Required | Default | Possible Values                                                                                | Description                                                                                                                            |
-| ---------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `options`        | `object`         | ✅       | —       | —                                                                                              |                                                                                                                                        |
-| ↳ `appKey`       | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')                                                                                    |
-| ↳ `actionType`   | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type                                                                                     |
-| ↳ `actionKey`    | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                                                                                                  |
-| ↳ `connectionId` | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use when running the action. Required if the action needs a connection to authenticate and interact with the service. |
-| ↳ `inputs`       | `object`         | ❌       | —       | —                                                                                              | Input parameters for the action                                                                                                        |
-| ↳ `timeoutMs`    | `number`         | ❌       | —       | —                                                                                              | Maximum time to wait for action completion in milliseconds (default: 180000)                                                           |
-| ↳ `pageSize`     | `number`         | ❌       | —       | —                                                                                              | Number of results per page                                                                                                             |
-| ↳ `maxItems`     | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                                                                                         |
-| ↳ `cursor`       | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                                                                                                   |
+| Name             | Type             | Required | Default | Possible Values                                                                                | Description                                                                                                                                                        |
+| ---------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `options`        | `object`         | ✅       | —       | —                                                                                              |                                                                                                                                                                    |
+| ↳ `appKey`       | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')                                                                                                                |
+| ↳ `actionType`   | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type                                                                                                                 |
+| ↳ `actionKey`    | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                                                                                                                              |
+| ↳ `connectionId` | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use when running the action. Required if the action needs a connection to authenticate and interact with the service.                             |
+| ↳ `connection`   | `string, number` | ❌       | —       | —                                                                                              | Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly. Mutually exclusive with connectionId. |
+| ↳ `inputs`       | `object`         | ❌       | —       | —                                                                                              | Input parameters for the action                                                                                                                                    |
+| ↳ `timeoutMs`    | `number`         | ❌       | —       | —                                                                                              | Maximum time to wait for action completion in milliseconds (default: 180000)                                                                                       |
+| ↳ `pageSize`     | `number`         | ❌       | —       | —                                                                                              | Number of results per page                                                                                                                                         |
+| ↳ `maxItems`     | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                                                                                                                     |
+| ↳ `cursor`       | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                                                                                                                               |
 
 **Returns:** `Promise<PaginatedResult<ActionResultItem>>`
 
@@ -611,14 +670,15 @@ for await (const actionResult of zapier
 
 #### `apps.{appKey}`
 
-Bind a connection ID to an app
+Bind a connection alias or numeric connectionId to an app
 
 **Parameters:**
 
-| Name             | Type             | Required | Default | Possible Values | Description                          |
-| ---------------- | ---------------- | -------- | ------- | --------------- | ------------------------------------ |
-| `options`        | `object`         | ✅       | —       | —               |                                      |
-| ↳ `connectionId` | `string, number` | ❌       | —       | —               | Connection ID to use for this action |
+| Name             | Type             | Required | Default | Possible Values | Description                                                                                                                  |
+| ---------------- | ---------------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `options`        | `object`         | ✅       | —       | —               |                                                                                                                              |
+| ↳ `connectionId` | `string, number` | ❌       | —       | —               | Connection ID to use for this action                                                                                         |
+| ↳ `connection`   | `string, number` | ❌       | —       | —               | Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly. |
 
 **Returns:** `Promise<AppProxy>`
 
@@ -634,12 +694,13 @@ Execute an action with the given inputs for the bound app, as an alternative to
 
 **Parameters:**
 
-| Name             | Type             | Required | Default | Possible Values | Description                                                                  |
-| ---------------- | ---------------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------- |
-| `options`        | `object`         | ✅       | —       | —               |                                                                              |
-| ↳ `inputs`       | `object`         | ❌       | —       | —               |                                                                              |
-| ↳ `connectionId` | `string, number` | ❌       | —       | —               | Connection ID to use for this action                                         |
-| ↳ `timeoutMs`    | `number`         | ❌       | —       | —               | Maximum time to wait for action completion in milliseconds (default: 180000) |
+| Name             | Type             | Required | Default | Possible Values | Description                                                                                                                  |
+| ---------------- | ---------------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `options`        | `object`         | ✅       | —       | —               |                                                                                                                              |
+| ↳ `inputs`       | `object`         | ❌       | —       | —               |                                                                                                                              |
+| ↳ `connectionId` | `string, number` | ❌       | —       | —               | Connection ID to use for this action                                                                                         |
+| ↳ `connection`   | `string, number` | ❌       | —       | —               | Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly. |
+| ↳ `timeoutMs`    | `number`         | ❌       | —       | —               | Maximum time to wait for action completion in milliseconds (default: 180000)                                                 |
 
 **Returns:** `Promise<PaginatedResult<ActionResultItem>>`
 
@@ -804,15 +865,16 @@ Find the first connection matching the criteria
 
 **Parameters:**
 
-| Name          | Type      | Required | Default | Possible Values | Description                                                                    |
-| ------------- | --------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------ |
-| `options`     | `object`  | ✅       | —       | —               |                                                                                |
-| ↳ `search`    | `string`  | ❌       | —       | —               | Search term to filter connections by title                                     |
-| ↳ `title`     | `string`  | ❌       | —       | —               | Filter connections by exact title match (searches first, then filters locally) |
-| ↳ `owner`     | `string`  | ❌       | —       | —               | Filter by owner, 'me' for your own connections or a specific user ID           |
-| ↳ `appKey`    | `string`  | ❌       | —       | —               | App key of connections to list (e.g., 'SlackCLIAPI' or slug like 'github')     |
-| ↳ `accountId` | `string`  | ❌       | —       | —               | Account ID to filter by                                                        |
-| ↳ `isExpired` | `boolean` | ❌       | —       | —               | Filter by expired status                                                       |
+| Name              | Type      | Required | Default | Possible Values | Description                                                                                                                                         |
+| ----------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`         | `object`  | ✅       | —       | —               |                                                                                                                                                     |
+| ↳ `search`        | `string`  | ❌       | —       | —               | Search term to filter connections by title                                                                                                          |
+| ↳ `title`         | `string`  | ❌       | —       | —               | Filter connections by exact title match (searches first, then filters locally)                                                                      |
+| ↳ `owner`         | `string`  | ❌       | —       | —               | Filter by owner, 'me' for your own connections or a specific user ID                                                                                |
+| ↳ `appKey`        | `string`  | ❌       | —       | —               | App key of connections to list (e.g., 'SlackCLIAPI' or slug like 'github')                                                                          |
+| ↳ `accountId`     | `string`  | ❌       | —       | —               | Account ID to filter by                                                                                                                             |
+| ↳ `includeShared` | `boolean` | ❌       | —       | —               | Include connections shared with you. By default, only your own connections are returned (owner=me). Set to true to also include shared connections. |
+| ↳ `isExpired`     | `boolean` | ❌       | —       | —               | Filter by expired status                                                                                                                            |
 
 **Returns:** `Promise<ConnectionItem>`
 
@@ -828,15 +890,16 @@ Find a unique connection matching the criteria
 
 **Parameters:**
 
-| Name          | Type      | Required | Default | Possible Values | Description                                                                    |
-| ------------- | --------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------ |
-| `options`     | `object`  | ✅       | —       | —               |                                                                                |
-| ↳ `search`    | `string`  | ❌       | —       | —               | Search term to filter connections by title                                     |
-| ↳ `title`     | `string`  | ❌       | —       | —               | Filter connections by exact title match (searches first, then filters locally) |
-| ↳ `owner`     | `string`  | ❌       | —       | —               | Filter by owner, 'me' for your own connections or a specific user ID           |
-| ↳ `appKey`    | `string`  | ❌       | —       | —               | App key of connections to list (e.g., 'SlackCLIAPI' or slug like 'github')     |
-| ↳ `accountId` | `string`  | ❌       | —       | —               | Account ID to filter by                                                        |
-| ↳ `isExpired` | `boolean` | ❌       | —       | —               | Filter by expired status                                                       |
+| Name              | Type      | Required | Default | Possible Values | Description                                                                                                                                         |
+| ----------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`         | `object`  | ✅       | —       | —               |                                                                                                                                                     |
+| ↳ `search`        | `string`  | ❌       | —       | —               | Search term to filter connections by title                                                                                                          |
+| ↳ `title`         | `string`  | ❌       | —       | —               | Filter connections by exact title match (searches first, then filters locally)                                                                      |
+| ↳ `owner`         | `string`  | ❌       | —       | —               | Filter by owner, 'me' for your own connections or a specific user ID                                                                                |
+| ↳ `appKey`        | `string`  | ❌       | —       | —               | App key of connections to list (e.g., 'SlackCLIAPI' or slug like 'github')                                                                          |
+| ↳ `accountId`     | `string`  | ❌       | —       | —               | Account ID to filter by                                                                                                                             |
+| ↳ `includeShared` | `boolean` | ❌       | —       | —               | Include connections shared with you. By default, only your own connections are returned (owner=me). Set to true to also include shared connections. |
+| ↳ `isExpired`     | `boolean` | ❌       | —       | —               | Filter by expired status                                                                                                                            |
 
 **Returns:** `Promise<ConnectionItem>`
 
@@ -871,19 +934,20 @@ List available connections with optional filtering
 
 **Parameters:**
 
-| Name              | Type      | Required | Default | Possible Values | Description                                                                    |
-| ----------------- | --------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------ |
-| `options`         | `object`  | ✅       | —       | —               |                                                                                |
-| ↳ `search`        | `string`  | ❌       | —       | —               | Search term to filter connections by title                                     |
-| ↳ `title`         | `string`  | ❌       | —       | —               | Filter connections by exact title match (searches first, then filters locally) |
-| ↳ `owner`         | `string`  | ❌       | —       | —               | Filter by owner, 'me' for your own connections or a specific user ID           |
-| ↳ `appKey`        | `string`  | ❌       | —       | —               | App key of connections to list (e.g., 'SlackCLIAPI' or slug like 'github')     |
-| ↳ `connectionIds` | `array`   | ❌       | —       | —               | List of connection IDs to filter by                                            |
-| ↳ `accountId`     | `string`  | ❌       | —       | —               | Account ID to filter by                                                        |
-| ↳ `isExpired`     | `boolean` | ❌       | —       | —               | Filter by expired status                                                       |
-| ↳ `pageSize`      | `number`  | ❌       | —       | —               | Number of connections per page                                                 |
-| ↳ `maxItems`      | `number`  | ❌       | —       | —               | Maximum total items to return across all pages                                 |
-| ↳ `cursor`        | `string`  | ❌       | —       | —               | Cursor to start from                                                           |
+| Name              | Type      | Required | Default | Possible Values | Description                                                                                                                                         |
+| ----------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`         | `object`  | ✅       | —       | —               |                                                                                                                                                     |
+| ↳ `search`        | `string`  | ❌       | —       | —               | Search term to filter connections by title                                                                                                          |
+| ↳ `title`         | `string`  | ❌       | —       | —               | Filter connections by exact title match (searches first, then filters locally)                                                                      |
+| ↳ `owner`         | `string`  | ❌       | —       | —               | Filter by owner, 'me' for your own connections or a specific user ID                                                                                |
+| ↳ `appKey`        | `string`  | ❌       | —       | —               | App key of connections to list (e.g., 'SlackCLIAPI' or slug like 'github')                                                                          |
+| ↳ `connectionIds` | `array`   | ❌       | —       | —               | List of connection IDs to filter by                                                                                                                 |
+| ↳ `accountId`     | `string`  | ❌       | —       | —               | Account ID to filter by                                                                                                                             |
+| ↳ `includeShared` | `boolean` | ❌       | —       | —               | Include connections shared with you. By default, only your own connections are returned (owner=me). Set to true to also include shared connections. |
+| ↳ `isExpired`     | `boolean` | ❌       | —       | —               | Filter by expired status                                                                                                                            |
+| ↳ `pageSize`      | `number`  | ❌       | —       | —               | Number of connections per page                                                                                                                      |
+| ↳ `maxItems`      | `number`  | ❌       | —       | —               | Maximum total items to return across all pages                                                                                                      |
+| ↳ `cursor`        | `string`  | ❌       | —       | —               | Cursor to start from                                                                                                                                |
 
 **Returns:** `Promise<PaginatedResult<ConnectionItem>>`
 
@@ -912,15 +976,16 @@ Make authenticated HTTP requests to any API through Zapier. Pass a connectionId
 
 **Parameters:**
 
-| Name             | Type                     | Required | Default | Possible Values                                            | Description                                                                                         |
-| ---------------- | ------------------------ | -------- | ------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
-| `url`            | `string, custom`         | ✅       | —       | —                                                          | The full URL of the API endpoint to call (proxied through Zapier's Relay service)                   |
-| `init`           | `object`                 | ❌       | —       | —                                                          | Request options including method, headers, body, and authentication                                 |
-| ↳ `method`       | `string`                 | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method for the request (defaults to GET)                                                       |
-| ↳ `headers`      | `object`                 | ❌       | —       | —                                                          | HTTP headers to include in the request                                                              |
-| ↳ `body`         | `string, custom, record` | ❌       | —       | —                                                          | Request body — plain objects and JSON strings are auto-detected and Content-Type is set accordingly |
-| ↳ `connectionId` | `string, number`         | ❌       | —       | —                                                          | Connection ID to use for this action                                                                |
-| ↳ `callbackUrl`  | `string`                 | ❌       | —       | —                                                          | URL to send async response to (makes request async)                                                 |
+| Name             | Type                     | Required | Default | Possible Values                                            | Description                                                                                                                  |
+| ---------------- | ------------------------ | -------- | ------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `url`            | `string, custom`         | ✅       | —       | —                                                          | The full URL of the API endpoint to call (proxied through Zapier's Relay service)                                            |
+| `init`           | `object`                 | ❌       | —       | —                                                          | Request options including method, headers, body, and authentication                                                          |
+| ↳ `method`       | `string`                 | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method for the request (defaults to GET)                                                                                |
+| ↳ `headers`      | `object`                 | ❌       | —       | —                                                          | HTTP headers to include in the request                                                                                       |
+| ↳ `body`         | `string, custom, record` | ❌       | —       | —                                                          | Request body — plain objects and JSON strings are auto-detected and Content-Type is set accordingly                          |
+| ↳ `connectionId` | `string, number`         | ❌       | —       | —                                                          | Connection ID to use for this action                                                                                         |
+| ↳ `connection`   | `string, number`         | ❌       | —       | —                                                          | Connection alias (string) or numeric connectionId. Strings are resolved from the connections map; numbers are used directly. |
+| ↳ `callbackUrl`  | `string`                 | ❌       | —       | —                                                          | URL to send async response to (makes request async)                                                                          |
 
 **Returns:** `Promise<Response>`
 
@@ -1204,16 +1269,17 @@ List tables available to the authenticated user
 
 **Parameters:**
 
-| Name         | Type     | Required | Default | Possible Values                  | Description                                                                 |
-| ------------ | -------- | -------- | ------- | -------------------------------- | --------------------------------------------------------------------------- |
-| `options`    | `object` | ✅       | —       | —                                |                                                                             |
-| ↳ `tableIds` | `array`  | ❌       | —       | —                                | Filter by specific table IDs                                                |
-| ↳ `kind`     | `string` | ❌       | —       | `table`, `virtual_table`, `both` | Filter by table type                                                        |
-| ↳ `search`   | `string` | ❌       | —       | —                                | Search term to filter tables by name                                        |
-| ↳ `owner`    | `string` | ❌       | —       | —                                | Filter by table owner. Use "me" for the current user, or a numeric user ID. |
-| ↳ `pageSize` | `number` | ❌       | —       | —                                | Number of tables per page                                                   |
-| ↳ `maxItems` | `number` | ❌       | —       | —                                | Maximum total items to return across all pages                              |
-| ↳ `cursor`   | `string` | ❌       | —       | —                                | Cursor to start from                                                        |
+| Name              | Type      | Required | Default | Possible Values                  | Description                                                                                                    |
+| ----------------- | --------- | -------- | ------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `options`         | `object`  | ✅       | —       | —                                |                                                                                                                |
+| ↳ `tableIds`      | `array`   | ❌       | —       | —                                | Filter by specific table IDs                                                                                   |
+| ↳ `kind`          | `string`  | ❌       | —       | `table`, `virtual_table`, `both` | Filter by table type                                                                                           |
+| ↳ `search`        | `string`  | ❌       | —       | —                                | Search term to filter tables by name                                                                           |
+| ↳ `owner`         | `string`  | ❌       | —       | —                                | Filter by table owner. Use "me" for the current user, or a numeric user ID. Requires includeShared to be true. |
+| ↳ `includeShared` | `boolean` | ❌       | —       | —                                | Include tables shared with you. Without this, only your own tables are returned.                               |
+| ↳ `pageSize`      | `number`  | ❌       | —       | —                                | Number of tables per page                                                                                      |
+| ↳ `maxItems`      | `number`  | ❌       | —       | —                                | Maximum total items to return across all pages                                                                 |
+| ↳ `cursor`        | `string`  | ❌       | —       | —                                | Cursor to start from                                                                                           |
 
 **Returns:** `Promise<PaginatedResult<TableItem>>`