airbyte-agent-zendesk-support 0.18.56__tar.gz → 0.18.57__tar.gz

airbyte_agent_zendesk_support-0.18.57/AUTH.md

@@ -0,0 +1,128 @@
+# Zendesk-Support authentication and configuration
+
+This page documents the authentication and configuration options for the Zendesk-Support agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `access_token` | `str` | Yes | OAuth 2.0 access token |
+| `refresh_token` | `str` | No | OAuth 2.0 refresh token (optional) |
+
+```python
+from airbyte_agent_zendesk-support import ZendeskSupportConnector
+from airbyte_agent_zendesk-support.models import ZendeskSupportOauth20AuthConfig
+
+connector = ZendeskSupportConnector(
+    auth_config=ZendeskSupportOauth20AuthConfig(
+        access_token="<OAuth 2.0 access token>",
+        refresh_token="<OAuth 2.0 refresh token (optional)>"
+    )
+)
+```
+
+#### Token
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `email` | `str` | Yes | Your Zendesk account email address |
+| `api_token` | `str` | Yes | Your Zendesk API token from Admin Center |
+
+```python
+from airbyte_agent_zendesk-support import ZendeskSupportConnector
+from airbyte_agent_zendesk-support.models import ZendeskSupportApiTokenAuthConfig
+
+connector = ZendeskSupportConnector(
+    auth_config=ZendeskSupportApiTokenAuthConfig(
+        email="<Your Zendesk account email address>",
+        api_token="<Your Zendesk API token from Admin Center>"
+    )
+)
+```
+
+### Hosted execution
+
+In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+#### OAuth
+
+Create a connector with OAuth credentials:
+
+```bash
+curl -X POST 'https://api.airbyte.ai/v1/integrations/sources' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "workspace_id": "<WORKSPACE_ID>",
+    "source_template_id": "<SOURCE_TEMPLATE_ID>",
+    "name": "My Zendesk-Support Connector",
+    "credentials": {
+      "access_token": "<OAuth 2.0 access token>",
+      "refresh_token": "<OAuth 2.0 refresh token (optional)>"
+    }
+  }'
+```
+
+#### Token
+
+Create a connector with Token credentials:
+
+```bash
+curl -X POST 'https://api.airbyte.ai/v1/integrations/sources' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "workspace_id": "<WORKSPACE_ID>",
+    "source_template_id": "<SOURCE_TEMPLATE_ID>",
+    "name": "My Zendesk-Support Connector",
+    "credentials": {
+      "email": "<Your Zendesk account email address>",
+      "api_token": "<Your Zendesk API token from Admin Center>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+
+**Python SDK**
+
+```python
+from airbyte_agent_zendesk-support import ZendeskSupportConnector
+
+connector = ZendeskSupportConnector(
+    external_user_id="<your-scoped-token>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ZendeskSupportConnector.describe
+async def zendesk-support_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/connectors/sources/<connector_id>/execute' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+
+## Configuration
+
+The Zendesk-Support connector requires the following configuration variables. These variables are used to construct the base API URL. Pass them via the `config` parameter when initializing the connector.
+
+| Variable | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `subdomain` | `string` | Yes | your-subdomain | Your Zendesk subdomain |

{airbyte_agent_zendesk_support-0.18.56 → airbyte_agent_zendesk_support-0.18.57}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Zendesk Support changelog
 
+## [0.18.57] - 2026-01-22
+- Updated connector definition (YAML version 0.1.7)
+- Source commit: 49e6dfe9
+- SDK version: 0.1.0
+
 ## [0.18.56] - 2026-01-22
 - Updated connector definition (YAML version 0.1.7)
 - Source commit: b27328e2

{airbyte_agent_zendesk_support-0.18.56 → airbyte_agent_zendesk_support-0.18.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-agent-zendesk-support
-Version: 0.18.56
+Version: 0.18.57
 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/
@@ -153,6 +153,6 @@ For the service's official API docs, see the [Zendesk-Support API reference](htt
 
 ## Version information
 
-- **Package version:** 0.18.56
+- **Package version:** 0.18.57
 - **Connector version:** 0.1.7
-- **Generated with Connector SDK commit SHA:** b27328e2162813ea6315b9f890a6784b0fb9caba
+- **Generated with Connector SDK commit SHA:** 49e6dfe93fc406c8d2ed525372608fa2766ebece

{airbyte_agent_zendesk_support-0.18.56 → airbyte_agent_zendesk_support-0.18.57}/README.md

@@ -120,6 +120,6 @@ For the service's official API docs, see the [Zendesk-Support API reference](htt
 
 ## Version information
 
-- **Package version:** 0.18.56
+- **Package version:** 0.18.57
 - **Connector version:** 0.1.7
-- **Generated with Connector SDK commit SHA:** b27328e2162813ea6315b9f890a6784b0fb9caba
+- **Generated with Connector SDK commit SHA:** 49e6dfe93fc406c8d2ed525372608fa2766ebece

{airbyte_agent_zendesk_support-0.18.56 → airbyte_agent_zendesk_support-0.18.57}/airbyte_agent_zendesk_support/_vendored/connector_sdk/auth_strategies.py

@@ -634,9 +634,7 @@ class OAuth2AuthStrategy(AuthStrategy):
             Headers dict with additional headers added
         """
         # Build template context with extracted secret values
-        template_context = {
-            key: extract_secret_value(value) for key, value in secrets.items()
-        }
+        template_context = {key: extract_secret_value(value) for key, value in secrets.items()}
 
         for header_name, value_template in additional_headers.items():
             # Use Jinja2 templating for variable substitution

{airbyte_agent_zendesk_support-0.18.56 → airbyte_agent_zendesk_support-0.18.57}/airbyte_agent_zendesk_support/_vendored/connector_sdk/executor/local_executor.py

@@ -694,9 +694,7 @@ class LocalExecutor:
         """
         return {key: value for key, value in params.items() if key in allowed_fields and value is not None}
 
-    def _extract_header_params(
-        self, endpoint: EndpointDefinition, params: dict[str, Any], body: dict[str, Any] | None = None
-    ) -> dict[str, str]:
+    def _extract_header_params(self, endpoint: EndpointDefinition, params: dict[str, Any], body: dict[str, Any] | None = None) -> dict[str, str]:
         """Extract header parameters from params and schema defaults.
 
         Also adds Content-Type header when there's a request body (unless already specified

{airbyte_agent_zendesk_support-0.18.56 → airbyte_agent_zendesk_support-0.18.57}/pyproject.toml

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