airbyte-agent-zendesk-support 0.18.78__tar.gz → 0.18.80__tar.gz

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/AUTH.md

@@ -87,6 +87,59 @@ curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
   }'
 ```
 
+
+
+#### Bring your own OAuth flow
+To implement your own OAuth flow, use Airbyte's server-side OAuth API endpoints. For a complete guide, see [Implement your own OAuth flow](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-server-side-oauth).
+
+**Step 1: Initiate the OAuth flow**
+
+Request a consent URL for your user.
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `external_user_id` | `string` | Yes | Your unique identifier for the end user |
+| `connector_type` | `string` | Yes | The connector type (e.g., "Zendesk-Support") |
+| `redirect_url` | `string` | Yes | URL to redirect to after OAuth authorization |
+
+Example request:
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors/oauth/initiate" \
+  -H "Authorization: Bearer <BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Zendesk-Support",
+    "redirect_url": "https://yourapp.com/oauth/callback"
+  }'
+```
+
+Redirect your user to the `consent_url` from the response. After they authorize, they'll be redirected back to your app with a `secret_id` query parameter.
+
+**Step 2: Create a connector with the secret ID**
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `external_user_id` | `string` | Yes | Your unique identifier for the end user |
+| `connector_type` | `string` | Yes | The connector type (e.g., "Zendesk-Support") |
+| `name` | `string` | Yes | A name for this connector instance |
+| `server_side_oauth_secret_id` | `string` | Yes | The secret_id from the OAuth callback |
+
+Example request:
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
+  -H "Authorization: Bearer <BEARER_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Zendesk-Support",
+    "name": "My Zendesk-Support Connector",
+    "server_side_oauth_secret_id": "<secret_id_from_callback>"
+  }'
+```
+
 #### Token
 Create a connector with Token credentials.
 

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Zendesk Support changelog
 
+## [0.18.80] - 2026-02-03
+- Updated connector definition (YAML version 0.1.11)
+- Source commit: 5c6dbf88
+- SDK version: 0.1.0
+
+## [0.18.79] - 2026-02-02
+- Updated connector definition (YAML version 0.1.11)
+- Source commit: 94024675
+- SDK version: 0.1.0
+
 ## [0.18.78] - 2026-02-02
 - Updated connector definition (YAML version 0.1.11)
 - Source commit: 9d9866b0

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-zendesk-support
-Version: 0.18.78
+Version: 0.18.80
 Summary: Airbyte Zendesk-Support Connector for AI platforms
 Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
 Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
@@ -157,7 +157,7 @@ See the official [Zendesk-Support API reference](https://developer.zendesk.com/a
 
 ## Version information
 
-- **Package version:** 0.18.78
+- **Package version:** 0.18.80
 - **Connector version:** 0.1.11
-- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
+- **Generated with Connector SDK commit SHA:** 5c6dbf883d3b057550333775bd83a78777527017
 - **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/zendesk-support/CHANGELOG.md)

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/README.md

@@ -124,7 +124,7 @@ See the official [Zendesk-Support API reference](https://developer.zendesk.com/a
 
 ## Version information
 
-- **Package version:** 0.18.78
+- **Package version:** 0.18.80
 - **Connector version:** 0.1.11
-- **Generated with Connector SDK commit SHA:** 9d9866b0aae8c3494d04d34e193b9bd860bfc1c6
+- **Generated with Connector SDK commit SHA:** 5c6dbf883d3b057550333775bd83a78777527017
 - **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/zendesk-support/CHANGELOG.md)

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/connector_model_loader.py

@@ -766,7 +766,6 @@ def _generate_default_auth_config(auth_type: AuthType) -> AirbyteAuthConfig:
                 )
             },
             auth_mapping={"token": "${token}"},
-            oneOf=None,
         )
     elif auth_type == AuthType.BASIC:
         return AirbyteAuthConfig(
@@ -793,7 +792,6 @@ def _generate_default_auth_config(auth_type: AuthType) -> AirbyteAuthConfig:
                 ),
             },
             auth_mapping={"username": "${username}", "password": "${password}"},
-            oneOf=None,
         )
     elif auth_type == AuthType.API_KEY:
         return AirbyteAuthConfig(
@@ -812,7 +810,6 @@ def _generate_default_auth_config(auth_type: AuthType) -> AirbyteAuthConfig:
                 )
             },
             auth_mapping={"api_key": "${api_key}"},
-            oneOf=None,
         )
     elif auth_type == AuthType.OAUTH2:
         # OAuth2: No fields are strictly required to support both modes:
@@ -865,7 +862,6 @@ def _generate_default_auth_config(auth_type: AuthType) -> AirbyteAuthConfig:
                 "client_id": "${client_id}",
                 "client_secret": "${client_secret}",
             },
-            oneOf=None,
         )
     else:
         # Unknown auth type - return minimal config
@@ -876,7 +872,6 @@ def _generate_default_auth_config(auth_type: AuthType) -> AirbyteAuthConfig:
             required=None,
             properties={},
             auth_mapping={},
-            oneOf=None,
         )
 
 

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/executor/local_executor.py

@@ -261,19 +261,10 @@ class LocalExecutor:
         auth_mapping = None
         required_fields: list[str] | None = None
 
-        # Check for single option (direct auth_mapping)
+        # Get auth_mapping from the config
         if user_config_spec.auth_mapping:
             auth_mapping = user_config_spec.auth_mapping
             required_fields = user_config_spec.required
-        # Check for oneOf (multiple auth options)
-        elif user_config_spec.one_of:
-            # Find the matching option based on which required fields are present
-            for option in user_config_spec.one_of:
-                option_required = option.required or []
-                if all(field in user_secrets for field in option_required):
-                    auth_mapping = option.auth_mapping
-                    required_fields = option_required
-                    break
 
         if not auth_mapping:
             # No matching auth_mapping found, use secrets as-is
@@ -546,23 +537,25 @@ class LocalExecutor:
             return ExecutionResult(success=False, data={}, error=str(e))
 
     async def check(self) -> ExecutionResult:
-        """Perform a health check by running a lightweight list operation.
+        """Perform a health check by running a lightweight operation.
 
         Finds the operation marked with preferred_for_check=True, or falls back
-        to the first list operation. Executes it with limit=1 to verify
-        connectivity and credentials.
+        to the first list operation. Executes it to verify connectivity and credentials.
+        For list operations, uses limit=1 to minimize data transfer.
 
         Returns:
             ExecutionResult with data containing status, error, and checked operation details.
         """
         check_entity = None
         check_endpoint = None
+        check_action = None
 
-        # Look for preferred check operation
+        # Look for preferred check operation (can be any action type)
         for (ent_name, op_action), endpoint in self._operation_index.items():
             if getattr(endpoint, "preferred_for_check", False):
                 check_entity = ent_name
                 check_endpoint = endpoint
+                check_action = op_action
                 break
 
         # Fallback to first list operation
@@ -571,18 +564,19 @@ class LocalExecutor:
                 if op_action == Action.LIST:
                     check_entity = ent_name
                     check_endpoint = endpoint
+                    check_action = op_action
                     break
 
-        if check_endpoint is None or check_entity is None:
+        if check_endpoint is None or check_entity is None or check_action is None:
             return ExecutionResult(
                 success=True,
                 data={
                     "status": "skipped",
-                    "error": "No list operation available for health check",
+                    "error": "No operation available for health check",
                 },
             )
 
-        # Find the standard handler to execute the list operation
+        # Find the standard handler to execute the operation
         standard_handler = next(
             (h for h in self._operation_handlers if isinstance(h, _StandardOperationHandler)),
             None,
@@ -598,13 +592,15 @@ class LocalExecutor:
             )
 
         try:
-            await standard_handler.execute_operation(check_entity, Action.LIST, {"limit": 1})
+            # Use limit=1 for list operations to minimize data transfer
+            params = {"limit": 1} if check_action == Action.LIST else {}
+            await standard_handler.execute_operation(check_entity, check_action, params)
             return ExecutionResult(
                 success=True,
                 data={
                     "status": "healthy",
                     "checked_entity": check_entity,
-                    "checked_action": "list",
+                    "checked_action": check_action.value,
                 },
             )
         except Exception as e:
@@ -614,7 +610,7 @@ class LocalExecutor:
                     "status": "unhealthy",
                     "error": str(e),
                     "checked_entity": check_entity,
-                    "checked_action": "list",
+                    "checked_action": check_action.value,
                 },
                 error=str(e),
             )

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/__init__.py

@@ -31,7 +31,6 @@ from .operations import Operation, PathItem
 from .security import (
     AirbyteAuthConfig,
     AuthConfigFieldSpec,
-    AuthConfigOption,
     OAuth2Flow,
     OAuth2Flows,
     SecurityRequirement,
@@ -55,7 +54,6 @@ __all__ = [
     "OAuth2Flow",
     "OAuth2Flows",
     "AirbyteAuthConfig",
-    "AuthConfigOption",
     "AuthConfigFieldSpec",
     # Component models
     "Components",

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/base.py

@@ -10,7 +10,7 @@ from enum import StrEnum
 from typing import Any, Dict
 from uuid import UUID
 
-from pydantic import BaseModel, ConfigDict, Field, field_validator
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 from pydantic_core import Url
 
 from .extensions import CacheConfig, ReplicationConfig, RetryConfig
@@ -210,3 +210,34 @@ class Server(BaseModel):
             raise ValueError("Server URL cannot be empty")
         # Allow both absolute URLs and relative paths
         return v
+
+    @model_validator(mode="after")
+    def validate_replication_environment_mapping(self) -> "Server":
+        """Validate that x-airbyte-replication-environment-mapping sources exist in variables.
+
+        For simple mappings like {"subdomain": "subdomain"}, the key is the source variable.
+        For transform mappings like {"domain": {"source": "subdomain", "format": "..."}},
+        the "source" field is the source variable.
+        """
+        env_mapping = self.x_airbyte_replication_environment_mapping
+        if not env_mapping or not self.variables:
+            return self
+
+        variable_names = set(self.variables.keys())
+
+        for env_key, mapping_value in env_mapping.items():
+            if isinstance(mapping_value, str):
+                source_var = env_key
+            elif isinstance(mapping_value, EnvironmentMappingTransform):
+                source_var = mapping_value.source
+            else:
+                continue
+
+            if source_var not in variable_names:
+                available = ", ".join(sorted(variable_names)) if variable_names else "(none)"
+                raise ValueError(
+                    f"x-airbyte-replication-environment-mapping: source variable '{source_var}' "
+                    f"not found in server variables. Available: {available}"
+                )
+
+        return self

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/extensions.py

@@ -14,7 +14,7 @@ are implemented.
 
 from typing import Literal
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, model_validator
 
 
 class PaginationConfig(BaseModel):
@@ -182,12 +182,25 @@ class CacheEntityConfig(BaseModel):
         return self.x_airbyte_name or self.entity
 
 
+class ReplicationConfigPropertyItems(BaseModel):
+    """
+    Items definition for array-type replication configuration fields.
+
+    Defines the schema for items in an array-type replication config property.
+    """
+
+    model_config = ConfigDict(populate_by_name=True, extra="forbid")
+
+    type: str
+
+
 class ReplicationConfigProperty(BaseModel):
     """
     Property definition for replication configuration fields.
 
     Defines a single field in the replication configuration with its type,
-    description, and optional default value.
+    description, and optional default value. Supports both simple types
+    (string, integer, boolean) and array types.
 
     Example YAML usage:
         x-airbyte-replication-config:
@@ -197,6 +210,12 @@ class ReplicationConfigProperty(BaseModel):
               title: Start Date
               description: UTC date and time from which to replicate data
               format: date-time
+            account_ids:
+              type: array
+              title: Account IDs
+              description: List of account IDs to replicate
+              items:
+                type: string
     """
 
     model_config = ConfigDict(populate_by_name=True, extra="forbid")
@@ -205,8 +224,9 @@ class ReplicationConfigProperty(BaseModel):
     title: str | None = None
     description: str | None = None
     format: str | None = None
-    default: str | int | float | bool | None = None
+    default: str | int | float | bool | list | None = None
     enum: list[str] | None = None
+    items: ReplicationConfigPropertyItems | None = None
 
 
 class ReplicationConfig(BaseModel):
@@ -252,6 +272,24 @@ class ReplicationConfig(BaseModel):
         description="Mapping from replication_config field names to source_config field names",
     )
 
+    @model_validator(mode="after")
+    def validate_replication_config_key_mapping(self) -> "ReplicationConfig":
+        """Validate that replication_config_key_mapping keys exist in properties.
+
+        The mapping is: {local_key: airbyte_path}
+        We validate that local_key exists in our properties.
+        """
+        if self.replication_config_key_mapping and self.properties:
+            property_names = set(self.properties.keys())
+            for local_key, airbyte_path in self.replication_config_key_mapping.items():
+                if local_key not in property_names:
+                    available = ", ".join(sorted(property_names)) if property_names else "(none)"
+                    raise ValueError(
+                        f"replication_config_key_mapping: local key '{local_key}' "
+                        f"(mapped to '{airbyte_path}') not found in properties. Available: {available}"
+                    )
+        return self
+
 
 class CacheConfig(BaseModel):
     """

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/operations.py

@@ -90,9 +90,10 @@ class Operation(BaseModel):
         None,
         alias="x-airbyte-preferred-for-check",
         description=(
-            "Mark this list operation as the preferred operation for health checks. "
+            "Mark this operation as the preferred operation for health checks. "
             "When the CHECK action is executed, this operation will be used instead of "
-            "falling back to the first available list operation. Choose a lightweight, "
+            "falling back to the first available list operation. The operation's actual "
+            "action type (get, list, etc.) will be respected. Choose a lightweight, "
             "always-available endpoint (e.g., users, accounts)."
         ),
     )

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/schema/security.py

@@ -58,30 +58,6 @@ class AuthConfigFieldSpec(BaseModel):
     default: Any | None = None
 
 
-class AuthConfigOption(BaseModel):
-    """
-    A single authentication configuration option.
-
-    Defines user-facing fields and how they map to auth parameters.
-    """
-
-    model_config = ConfigDict(populate_by_name=True, extra="forbid")
-
-    title: str | None = None
-    description: str | None = None
-    type: Literal["object"] = "object"
-    required: List[str] = Field(default_factory=list)
-    properties: Dict[str, AuthConfigFieldSpec] = Field(default_factory=dict)
-    auth_mapping: Dict[str, str] = Field(
-        default_factory=dict,
-        description="Mapping from auth parameters (e.g., 'username', 'password', 'token') to template strings using ${field} syntax",
-    )
-    replication_auth_key_mapping: Dict[str, str] | None = Field(
-        None,
-        description="Mapping from source config paths (e.g., 'credentials.api_key') to auth config keys for direct connectors",
-    )
-
-
 class AirbyteAuthConfig(BaseModel):
     """
     Airbyte auth configuration extension (x-airbyte-auth-config).
@@ -89,12 +65,12 @@ class AirbyteAuthConfig(BaseModel):
     Defines user-facing authentication configuration and how it maps to
     the underlying OpenAPI security scheme.
 
-    Either a single auth option or multiple options via oneOf.
+    For multiple authentication methods, define separate security schemes
+    rather than using oneOf within a single scheme.
     """
 
     model_config = ConfigDict(populate_by_name=True, extra="forbid")
 
-    # Single option fields
     title: str | None = None
     description: str | None = None
     type: Literal["object"] | None = None
@@ -122,32 +98,48 @@ class AirbyteAuthConfig(BaseModel):
         None,
         description="Constant values to always inject at source config paths (e.g., 'credentials.auth_type': 'OAuth2.0')",
     )
-    # Multiple options (oneOf)
-    one_of: List[AuthConfigOption] | None = Field(None, alias="oneOf")
 
     @model_validator(mode="after")
     def validate_config_structure(self) -> "AirbyteAuthConfig":
-        """Validate that either single option or oneOf is provided, not both."""
-        has_single = self.type is not None or self.properties is not None or self.auth_mapping is not None
-        has_one_of = self.one_of is not None and len(self.one_of) > 0
-
-        if not has_single and not has_one_of:
-            raise ValueError("Either single auth option (type/properties/auth_mapping) or oneOf must be provided")
+        """Validate that required fields are provided for auth config."""
+        has_config = self.type is not None or self.properties is not None or self.auth_mapping is not None
 
-        if has_single and has_one_of:
-            raise ValueError("Cannot have both single auth option and oneOf")
+        if not has_config:
+            raise ValueError("Auth config must have type, properties, and auth_mapping")
 
-        if has_single:
-            # Validate single option has required fields
+        if has_config:
+            # Validate required fields
             if self.type != "object":
-                raise ValueError("Single auth option must have type='object'")
+                raise ValueError("Auth config must have type='object'")
             if not self.properties:
-                raise ValueError("Single auth option must have properties")
+                raise ValueError("Auth config must have properties")
             if not self.auth_mapping:
-                raise ValueError("Single auth option must have auth_mapping")
+                raise ValueError("Auth config must have auth_mapping")
+
+            # Validate replication_auth_key_mapping targets exist in properties
+            if self.replication_auth_key_mapping and self.properties:
+                self._validate_replication_auth_key_mapping(self.replication_auth_key_mapping, self.properties, context="x-airbyte-auth-config")
 
         return self
 
+    @staticmethod
+    def _validate_replication_auth_key_mapping(mapping: Dict[str, str], properties: Dict[str, AuthConfigFieldSpec], context: str) -> None:
+        """Validate that replication_auth_key_mapping target keys exist in properties.
+
+        Args:
+            mapping: The replication_auth_key_mapping dict (airbyte_path -> our_key)
+            properties: The properties dict from x-airbyte-auth-config
+            context: Context string for error messages
+        """
+        property_names = set(properties.keys())
+        for airbyte_path, our_key in mapping.items():
+            if our_key not in property_names:
+                available = ", ".join(sorted(property_names)) if property_names else "(none)"
+                raise ValueError(
+                    f"replication_auth_key_mapping in {context}: target key '{our_key}' "
+                    f"(mapped from '{airbyte_path}') not found in properties. Available: {available}"
+                )
+
 
 class SecurityScheme(BaseModel):
     """

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/types.py

@@ -239,7 +239,7 @@ class EndpointDefinition(BaseModel):
     # Health check support (Airbyte extension)
     preferred_for_check: bool = Field(
         False,
-        description="Mark this list operation as preferred for health checks (from x-airbyte-preferred-for-check extension)",
+        description="Mark this operation as preferred for health checks (from x-airbyte-preferred-for-check extension)",
     )
 
 

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/airbyte_agent_zendesk_support/_vendored/connector_sdk/validation.py

@@ -959,7 +959,7 @@ def validate_connector_readiness(connector_dir: str | Path) -> Dict[str, Any]:
     if not has_preferred_check:
         readiness_warnings.append(
             "No operation has x-airbyte-preferred-for-check: true. "
-            "Add this extension to a lightweight list operation (e.g., users.list) "
+            "Add this extension to a lightweight operation (e.g., users.list or accounts.get) "
             "to enable reliable health checks."
         )
 

{airbyte_agent_zendesk_support-0.18.78 → airbyte_agent_zendesk_support-0.18.80}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "airbyte-agent-zendesk-support"
-version = "0.18.78"
+version = "0.18.80"
 description = "Airbyte Zendesk-Support Connector for AI platforms"
 readme = "README.md"
 requires-python = ">=3.13"