airbyte-agent-slack 0.1.20__tar.gz → 0.1.22__tar.gz

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/AUTH.md

@@ -103,7 +103,7 @@ connector = SlackConnector(
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@SlackConnector.describe
+@SlackConnector.tool_utils
 async def slack_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Slack changelog
 
+## [0.1.22] - 2026-01-24
+- Updated connector definition (YAML version 0.1.8)
+- Source commit: 609c1d86
+- SDK version: 0.1.0
+
+## [0.1.21] - 2026-01-23
+- Updated connector definition (YAML version 0.1.8)
+- Source commit: 32c5ef46
+- SDK version: 0.1.0
+
 ## [0.1.20] - 2026-01-23
 - Updated connector definition (YAML version 0.1.7)
 - Source commit: 049f6ad5

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-slack
-Version: 0.1.20
+Version: 0.1.22
 Summary: Airbyte Slack Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -104,7 +104,7 @@ connector = SlackConnector(
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@SlackConnector.describe
+@SlackConnector.tool_utils
 async def slack_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
@@ -125,7 +125,7 @@ connector = SlackConnector(
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@SlackConnector.describe
+@SlackConnector.tool_utils
 async def slack_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
@@ -158,6 +158,6 @@ For the service's official API docs, see the [Slack API reference](https://api.s
 
 ## Version information
 
-- **Package version:** 0.1.20
-- **Connector version:** 0.1.7
-- **Generated with Connector SDK commit SHA:** 049f6ad546186bde8303b77e0e1001a831a58654
+- **Package version:** 0.1.22
+- **Connector version:** 0.1.8
+- **Generated with Connector SDK commit SHA:** 609c1d86c76b36ff699b57123a5a8c2050d958c3

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/README.md

@@ -71,7 +71,7 @@ connector = SlackConnector(
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@SlackConnector.describe
+@SlackConnector.tool_utils
 async def slack_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
@@ -92,7 +92,7 @@ connector = SlackConnector(
 )
 
 @agent.tool_plain # assumes you're using Pydantic AI
-@SlackConnector.describe
+@SlackConnector.tool_utils
 async def slack_execute(entity: str, action: str, params: dict | None = None):
     return await connector.execute(entity, action, params or {})
 ```
@@ -125,6 +125,6 @@ For the service's official API docs, see the [Slack API reference](https://api.s
 
 ## Version information
 
-- **Package version:** 0.1.20
-- **Connector version:** 0.1.7
-- **Generated with Connector SDK commit SHA:** 049f6ad546186bde8303b77e0e1001a831a58654
+- **Package version:** 0.1.22
+- **Connector version:** 0.1.8
+- **Generated with Connector SDK commit SHA:** 609c1d86c76b36ff699b57123a5a8c2050d958c3

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/REFERENCE.md

@@ -8,8 +8,8 @@ The Slack connector supports the following entities and actions.
 
 | Entity | Actions |
 |--------|---------|
-| Users | [List](#users-list), [Get](#users-get) |
-| Channels | [List](#channels-list), [Get](#channels-get), [Create](#channels-create), [Update](#channels-update) |
+| Users | [List](#users-list), [Get](#users-get), [Search](#users-search) |
+| Channels | [List](#channels-list), [Get](#channels-get), [Create](#channels-create), [Update](#channels-update), [Search](#channels-search) |
 | Channel Messages | [List](#channel-messages-list) |
 | Threads | [List](#threads-list) |
 | Messages | [Create](#messages-create), [Update](#messages-update) |
@@ -151,6 +151,109 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 | `who_can_share_contact_card` | `string \| null` |  |
 
 
+</details>
+
+### Users Search
+
+Search and filter users records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
+
+#### Python SDK
+
+```python
+await slack.users.search(
+    query={"filter": {"eq": {"color": "<str>"}}}
+)
+```
+
+#### API
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "users",
+    "action": "search",
+    "params": {
+        "query": {"filter": {"eq": {"color": "<str>"}}}
+    }
+}'
+```
+
+#### Parameters
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `object` | Yes | Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or |
+| `query.filter` | `object` | No | Filter conditions |
+| `query.sort` | `array` | No | Sort conditions |
+| `limit` | `integer` | No | Maximum results to return (default 1000) |
+| `cursor` | `string` | No | Pagination cursor from previous response's next_cursor |
+| `fields` | `array` | No | Field paths to include in results |
+
+#### Searchable Fields
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `color` | `string` | The color assigned to the user for visual purposes. |
+| `deleted` | `boolean` | Indicates if the user is deleted or not. |
+| `has_2fa` | `boolean` | Flag indicating if the user has two-factor authentication enabled. |
+| `id` | `string` | Unique identifier for the user. |
+| `is_admin` | `boolean` | Flag specifying if the user is an admin or not. |
+| `is_app_user` | `boolean` | Specifies if the user is an app user. |
+| `is_bot` | `boolean` | Indicates if the user is a bot account. |
+| `is_email_confirmed` | `boolean` | Flag indicating if the user's email is confirmed. |
+| `is_forgotten` | `boolean` | Specifies if the user is marked as forgotten. |
+| `is_invited_user` | `boolean` | Indicates if the user is invited or not. |
+| `is_owner` | `boolean` | Flag indicating if the user is an owner. |
+| `is_primary_owner` | `boolean` | Specifies if the user is the primary owner. |
+| `is_restricted` | `boolean` | Flag specifying if the user is restricted. |
+| `is_ultra_restricted` | `boolean` | Indicates if the user has ultra-restricted access. |
+| `name` | `string` | The username of the user. |
+| `profile` | `object` | User's profile information containing detailed details. |
+| `real_name` | `string` | The real name of the user. |
+| `team_id` | `string` | Unique identifier for the team the user belongs to. |
+| `tz` | `string` | Timezone of the user. |
+| `tz_label` | `string` | Label representing the timezone of the user. |
+| `tz_offset` | `integer` | Offset of the user's timezone. |
+| `updated` | `integer` | Timestamp of when the user's information was last updated. |
+| `who_can_share_contact_card` | `string` | Specifies who can share the user's contact card. |
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `hits` | `array` | List of matching records |
+| `hits[].id` | `string` | Record identifier |
+| `hits[].score` | `number` | Relevance score |
+| `hits[].data` | `object` | Record data containing the searchable fields listed above |
+| `hits[].data.color` | `string` | The color assigned to the user for visual purposes. |
+| `hits[].data.deleted` | `boolean` | Indicates if the user is deleted or not. |
+| `hits[].data.has_2fa` | `boolean` | Flag indicating if the user has two-factor authentication enabled. |
+| `hits[].data.id` | `string` | Unique identifier for the user. |
+| `hits[].data.is_admin` | `boolean` | Flag specifying if the user is an admin or not. |
+| `hits[].data.is_app_user` | `boolean` | Specifies if the user is an app user. |
+| `hits[].data.is_bot` | `boolean` | Indicates if the user is a bot account. |
+| `hits[].data.is_email_confirmed` | `boolean` | Flag indicating if the user's email is confirmed. |
+| `hits[].data.is_forgotten` | `boolean` | Specifies if the user is marked as forgotten. |
+| `hits[].data.is_invited_user` | `boolean` | Indicates if the user is invited or not. |
+| `hits[].data.is_owner` | `boolean` | Flag indicating if the user is an owner. |
+| `hits[].data.is_primary_owner` | `boolean` | Specifies if the user is the primary owner. |
+| `hits[].data.is_restricted` | `boolean` | Flag specifying if the user is restricted. |
+| `hits[].data.is_ultra_restricted` | `boolean` | Indicates if the user has ultra-restricted access. |
+| `hits[].data.name` | `string` | The username of the user. |
+| `hits[].data.profile` | `object` | User's profile information containing detailed details. |
+| `hits[].data.real_name` | `string` | The real name of the user. |
+| `hits[].data.team_id` | `string` | Unique identifier for the team the user belongs to. |
+| `hits[].data.tz` | `string` | Timezone of the user. |
+| `hits[].data.tz_label` | `string` | Label representing the timezone of the user. |
+| `hits[].data.tz_offset` | `integer` | Offset of the user's timezone. |
+| `hits[].data.updated` | `integer` | Timestamp of when the user's information was last updated. |
+| `hits[].data.who_can_share_contact_card` | `string` | Specifies who can share the user's contact card. |
+| `next_cursor` | `string \| null` | Cursor for next page of results |
+| `took_ms` | `number` | Query execution time in milliseconds |
+
 </details>
 
 ## Channels
@@ -471,6 +574,125 @@ curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_i
 | `is_read_only` | `boolean \| null` |  |
 
 
+</details>
+
+### Channels Search
+
+Search and filter channels records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
+
+#### Python SDK
+
+```python
+await slack.channels.search(
+    query={"filter": {"eq": {"context_team_id": "<str>"}}}
+)
+```
+
+#### API
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "channels",
+    "action": "search",
+    "params": {
+        "query": {"filter": {"eq": {"context_team_id": "<str>"}}}
+    }
+}'
+```
+
+#### Parameters
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `object` | Yes | Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or |
+| `query.filter` | `object` | No | Filter conditions |
+| `query.sort` | `array` | No | Sort conditions |
+| `limit` | `integer` | No | Maximum results to return (default 1000) |
+| `cursor` | `string` | No | Pagination cursor from previous response's next_cursor |
+| `fields` | `array` | No | Field paths to include in results |
+
+#### Searchable Fields
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `context_team_id` | `string` | The unique identifier of the team context in which the channel exists. |
+| `created` | `integer` | The timestamp when the channel was created. |
+| `creator` | `string` | The ID of the user who created the channel. |
+| `id` | `string` | The unique identifier of the channel. |
+| `is_archived` | `boolean` | Indicates if the channel is archived. |
+| `is_channel` | `boolean` | Indicates if the entity is a channel. |
+| `is_ext_shared` | `boolean` | Indicates if the channel is externally shared. |
+| `is_general` | `boolean` | Indicates if the channel is a general channel in the workspace. |
+| `is_group` | `boolean` | Indicates if the channel is a group (private channel) rather than a regular channel. |
+| `is_im` | `boolean` | Indicates if the entity is a direct message (IM) channel. |
+| `is_member` | `boolean` | Indicates if the calling user is a member of the channel. |
+| `is_mpim` | `boolean` | Indicates if the entity is a multiple person direct message (MPIM) channel. |
+| `is_org_shared` | `boolean` | Indicates if the channel is organization-wide shared. |
+| `is_pending_ext_shared` | `boolean` | Indicates if the channel is pending external shared. |
+| `is_private` | `boolean` | Indicates if the channel is a private channel. |
+| `is_read_only` | `boolean` | Indicates if the channel is read-only. |
+| `is_shared` | `boolean` | Indicates if the channel is shared. |
+| `last_read` | `string` | The timestamp of the user's last read message in the channel. |
+| `locale` | `string` | The locale of the channel. |
+| `name` | `string` | The name of the channel. |
+| `name_normalized` | `string` | The normalized name of the channel. |
+| `num_members` | `integer` | The number of members in the channel. |
+| `parent_conversation` | `string` | The parent conversation of the channel. |
+| `pending_connected_team_ids` | `array` | The IDs of teams that are pending to be connected to the channel. |
+| `pending_shared` | `array` | The list of pending shared items of the channel. |
+| `previous_names` | `array` | The previous names of the channel. |
+| `purpose` | `object` | The purpose of the channel. |
+| `shared_team_ids` | `array` | The IDs of teams with which the channel is shared. |
+| `topic` | `object` | The topic of the channel. |
+| `unlinked` | `integer` | Indicates if the channel is unlinked. |
+| `updated` | `integer` | The timestamp when the channel was last updated. |
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `hits` | `array` | List of matching records |
+| `hits[].id` | `string` | Record identifier |
+| `hits[].score` | `number` | Relevance score |
+| `hits[].data` | `object` | Record data containing the searchable fields listed above |
+| `hits[].data.context_team_id` | `string` | The unique identifier of the team context in which the channel exists. |
+| `hits[].data.created` | `integer` | The timestamp when the channel was created. |
+| `hits[].data.creator` | `string` | The ID of the user who created the channel. |
+| `hits[].data.id` | `string` | The unique identifier of the channel. |
+| `hits[].data.is_archived` | `boolean` | Indicates if the channel is archived. |
+| `hits[].data.is_channel` | `boolean` | Indicates if the entity is a channel. |
+| `hits[].data.is_ext_shared` | `boolean` | Indicates if the channel is externally shared. |
+| `hits[].data.is_general` | `boolean` | Indicates if the channel is a general channel in the workspace. |
+| `hits[].data.is_group` | `boolean` | Indicates if the channel is a group (private channel) rather than a regular channel. |
+| `hits[].data.is_im` | `boolean` | Indicates if the entity is a direct message (IM) channel. |
+| `hits[].data.is_member` | `boolean` | Indicates if the calling user is a member of the channel. |
+| `hits[].data.is_mpim` | `boolean` | Indicates if the entity is a multiple person direct message (MPIM) channel. |
+| `hits[].data.is_org_shared` | `boolean` | Indicates if the channel is organization-wide shared. |
+| `hits[].data.is_pending_ext_shared` | `boolean` | Indicates if the channel is pending external shared. |
+| `hits[].data.is_private` | `boolean` | Indicates if the channel is a private channel. |
+| `hits[].data.is_read_only` | `boolean` | Indicates if the channel is read-only. |
+| `hits[].data.is_shared` | `boolean` | Indicates if the channel is shared. |
+| `hits[].data.last_read` | `string` | The timestamp of the user's last read message in the channel. |
+| `hits[].data.locale` | `string` | The locale of the channel. |
+| `hits[].data.name` | `string` | The name of the channel. |
+| `hits[].data.name_normalized` | `string` | The normalized name of the channel. |
+| `hits[].data.num_members` | `integer` | The number of members in the channel. |
+| `hits[].data.parent_conversation` | `string` | The parent conversation of the channel. |
+| `hits[].data.pending_connected_team_ids` | `array` | The IDs of teams that are pending to be connected to the channel. |
+| `hits[].data.pending_shared` | `array` | The list of pending shared items of the channel. |
+| `hits[].data.previous_names` | `array` | The previous names of the channel. |
+| `hits[].data.purpose` | `object` | The purpose of the channel. |
+| `hits[].data.shared_team_ids` | `array` | The IDs of teams with which the channel is shared. |
+| `hits[].data.topic` | `object` | The topic of the channel. |
+| `hits[].data.unlinked` | `integer` | Indicates if the channel is unlinked. |
+| `hits[].data.updated` | `integer` | The timestamp when the channel was last updated. |
+| `next_cursor` | `string \| null` | Cursor for next page of results |
+| `took_ms` | `number` | Query execution time in milliseconds |
+
 </details>
 
 ## Channel Messages

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/airbyte_agent_slack/__init__.py

@@ -18,8 +18,8 @@ from .models import (
     ChannelsListResponse,
     ChannelResponse,
     Reaction,
-    Attachment,
     File,
+    Attachment,
     Message,
     Thread,
     EditedInfo,
@@ -50,7 +50,13 @@ from .models import (
     UsersListResult,
     ChannelsListResult,
     ChannelMessagesListResult,
-    ThreadsListResult
+    ThreadsListResult,
+    AirbyteSearchHit,
+    AirbyteSearchResult,
+    ChannelsSearchData,
+    ChannelsSearchResult,
+    UsersSearchData,
+    UsersSearchResult
 )
 from .types import (
     UsersListParams,
@@ -65,7 +71,15 @@ from .types import (
     ChannelsUpdateParams,
     ChannelTopicsCreateParams,
     ChannelPurposesCreateParams,
-    ReactionsCreateParams
+    ReactionsCreateParams,
+    AirbyteSearchParams,
+    AirbyteSortOrder,
+    ChannelsSearchFilter,
+    ChannelsSearchQuery,
+    ChannelsCondition,
+    UsersSearchFilter,
+    UsersSearchQuery,
+    UsersCondition
 )
 
 __all__ = [
@@ -82,8 +96,8 @@ __all__ = [
     "ChannelsListResponse",
     "ChannelResponse",
     "Reaction",
-    "Attachment",
     "File",
+    "Attachment",
     "Message",
     "Thread",
     "EditedInfo",
@@ -115,6 +129,12 @@ __all__ = [
     "ChannelsListResult",
     "ChannelMessagesListResult",
     "ThreadsListResult",
+    "AirbyteSearchHit",
+    "AirbyteSearchResult",
+    "ChannelsSearchData",
+    "ChannelsSearchResult",
+    "UsersSearchData",
+    "UsersSearchResult",
     "UsersListParams",
     "UsersGetParams",
     "ChannelsListParams",
@@ -128,4 +148,12 @@ __all__ = [
     "ChannelTopicsCreateParams",
     "ChannelPurposesCreateParams",
     "ReactionsCreateParams",
+    "AirbyteSearchParams",
+    "AirbyteSortOrder",
+    "ChannelsSearchFilter",
+    "ChannelsSearchQuery",
+    "ChannelsCondition",
+    "UsersSearchFilter",
+    "UsersSearchQuery",
+    "UsersCondition",
 ]

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/airbyte_agent_slack/_vendored/connector_sdk/connector_model_loader.py

@@ -145,6 +145,87 @@ def _deproxy_schema(obj: Any) -> Any:
         return obj
 
 
+def _type_includes(type_value: Any, target: str) -> bool:
+    if isinstance(type_value, list):
+        return target in type_value
+    return type_value == target
+
+
+def _flatten_cache_properties(properties: dict[str, Any], prefix: str) -> list[str]:
+    entries: list[str] = []
+    for prop_name, prop in properties.items():
+        path = f"{prefix}{prop_name}" if prefix else prop_name
+        entries.append(path)
+
+        prop_type = getattr(prop, "type", None) if not isinstance(prop, dict) else prop.get("type")
+        prop_properties = getattr(prop, "properties", None) if not isinstance(prop, dict) else prop.get("properties")
+
+        if _type_includes(prop_type, "array"):
+            array_path = f"{path}[]"
+            entries.append(array_path)
+            if isinstance(prop_properties, dict):
+                entries.extend(_flatten_cache_properties(prop_properties, prefix=f"{array_path}."))
+        elif isinstance(prop_properties, dict):
+            entries.extend(_flatten_cache_properties(prop_properties, prefix=f"{path}."))
+
+    return entries
+
+
+def _flatten_cache_field_paths(field: Any) -> list[str]:
+    field_name = getattr(field, "name", None) if not isinstance(field, dict) else field.get("name")
+    if not isinstance(field_name, str) or not field_name:
+        return []
+
+    field_type = getattr(field, "type", None) if not isinstance(field, dict) else field.get("type")
+    field_properties = getattr(field, "properties", None) if not isinstance(field, dict) else field.get("properties")
+
+    entries = [field_name]
+    if _type_includes(field_type, "array"):
+        array_path = f"{field_name}[]"
+        entries.append(array_path)
+        if isinstance(field_properties, dict):
+            entries.extend(_flatten_cache_properties(field_properties, prefix=f"{array_path}."))
+    elif isinstance(field_properties, dict):
+        entries.extend(_flatten_cache_properties(field_properties, prefix=f"{field_name}."))
+
+    return entries
+
+
+def _dedupe_strings(values: list[str]) -> list[str]:
+    seen: set[str] = set()
+    ordered: list[str] = []
+    for value in values:
+        if value not in seen:
+            seen.add(value)
+            ordered.append(value)
+    return ordered
+
+
+def _extract_search_field_paths(spec: OpenAPIConnector) -> dict[str, list[str]]:
+    cache_config = getattr(spec.info, "x_airbyte_cache", None)
+    entities = getattr(cache_config, "entities", None)
+    if not isinstance(entities, list):
+        return {}
+
+    search_fields: dict[str, list[str]] = {}
+    for entity in entities:
+        entity_name = getattr(entity, "entity", None) if not isinstance(entity, dict) else entity.get("entity")
+        if not isinstance(entity_name, str) or not entity_name:
+            continue
+
+        fields = getattr(entity, "fields", None) if not isinstance(entity, dict) else entity.get("fields")
+        if not isinstance(fields, list):
+            continue
+
+        field_paths: list[str] = []
+        for field in fields:
+            field_paths.extend(_flatten_cache_field_paths(field))
+
+        search_fields[entity_name] = _dedupe_strings(field_paths)
+
+    return search_fields
+
+
 def parse_openapi_spec(raw_config: dict) -> OpenAPIConnector:
     """Parse OpenAPI specification from YAML.
 
@@ -434,6 +515,8 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
     if not connector_id:
         raise InvalidOpenAPIError("Missing required x-airbyte-connector-id field")
 
+    search_field_paths = _extract_search_field_paths(spec)
+
     # Create ConnectorModel
     model = ConnectorModel(
         id=connector_id,
@@ -444,6 +527,7 @@ def convert_openapi_to_connector_model(spec: OpenAPIConnector) -> ConnectorModel
         entities=entities,
         openapi_spec=spec,
         retry_config=retry_config,
+        search_field_paths=search_field_paths,
     )
 
     return model

{airbyte_agent_slack-0.1.20 → airbyte_agent_slack-0.1.22}/airbyte_agent_slack/_vendored/connector_sdk/executor/local_executor.py

@@ -1032,7 +1032,9 @@ class LocalExecutor:
         if "variables" in graphql_config and graphql_config["variables"]:
             variables = self._interpolate_variables(graphql_config["variables"], params, param_defaults)
             # Filter out None values (optional fields not provided) - matches REST _extract_body() behavior
-            body["variables"] = {k: v for k, v in variables.items() if v is not None}
+            # But preserve None for variables explicitly marked as nullable (e.g., to unassign a user)
+            nullable_vars = set(graphql_config.get("x-airbyte-nullable-variables") or [])
+            body["variables"] = {k: v for k, v in variables.items() if v is not None or k in nullable_vars}
 
         # Add operation name if specified
         if "operationName" in graphql_config: