Merge pull request #3212 from airbytehq/publish/sendgrid-v0.1.23

chore(sendgrid): bump to 0.1.23

Author: octavia-bot-hoard[bot]

connectors/sendgrid/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Sendgrid changelog
 
+## [0.1.23] - 2026-04-09
+- Updated connector definition (YAML version 1.0.3)
+- Source commit: c5258deb
+- SDK version: 0.1.0
+
 ## [0.1.22] - 2026-04-09
 - Updated connector definition (YAML version 1.0.3)
 - Source commit: 6bf360a5

connectors/sendgrid/README.md

@@ -121,7 +121,7 @@ See the official [Sendgrid API reference](https://docs.sendgrid.com/api-referenc
 
 ## Version information
 
-- **Package version:** 0.1.22
+- **Package version:** 0.1.23
 - **Connector version:** 1.0.3
-- **Generated with Connector SDK commit SHA:** 6bf360a546d577c9f76e8a6b8abf9ffc4dbfcf3a
+- **Generated with Connector SDK commit SHA:** c5258debd165ab701252c1436d4acfb475bf92b9
 - **Changelog:** [View changelog](https://github.com/airbytehq/airbyte-agent-connectors/blob/main/connectors/sendgrid/CHANGELOG.md)

connectors/sendgrid/airbyte_agent_sendgrid/__init__.py

@@ -20,8 +20,8 @@
     Campaign,
     CampaignsListMetadata,
     CampaignsList,
-    SingleSendEmailConfig,
     SingleSendSendTo,
+    SingleSendEmailConfig,
     SingleSend,
     SingleSendsListMetadata,
     SingleSendsList,
@@ -170,8 +170,8 @@
     "Campaign",
     "CampaignsListMetadata",
     "CampaignsList",
-    "SingleSendEmailConfig",
     "SingleSendSendTo",
+    "SingleSendEmailConfig",
     "SingleSend",
     "SingleSendsListMetadata",
     "SingleSendsList",

connectors/sendgrid/airbyte_agent_sendgrid/_vendored/connector_sdk/executor/local_executor.py

@@ -62,7 +62,36 @@
 
 
 class ParamResolutionError(Exception):
-    """Raised when a path parameter cannot be resolved for entity probing."""
+    """Raised when a path parameter cannot be resolved for entity probing.
+
+    Covers structural resolution failures (unresolvable param, self-reference,
+    parent with no LIST op, parent returning no records, missing parent key,
+    max recursion depth). ``_probe_entity`` converts these into UNHEALTHY
+    results so the backend controller classifies them as INCONCLUSIVE. SKIPPED
+    is reserved exclusively for "this entity has no list/get action at all".
+
+    Execution failures from probing a parent entity use ParentProbeError
+    instead, so the child can inherit the parent's ``status_code`` for
+    401/403 -> FAILED classification.
+    """
+
+
+class ParentProbeError(Exception):
+    """Raised when a parent entity's LIST probe fails during param resolution.
+
+    Wraps the original exception's message with parent-entity context for
+    debuggability, while preserving the parent's ``status_code`` so the child
+    can be classified the same way the parent would be (401/403 -> FAILED,
+    everything else -> INCONCLUSIVE at the backend controller layer).
+
+    Distinct from ``ParamResolutionError`` so the ``status_code`` survives --
+    both route through ``_probe_entity``'s UNHEALTHY branch, but only
+    ParentProbeError carries the parent's HTTP status.
+    """
+
+    def __init__(self, message: str, status_code: int | None = None) -> None:
+        super().__init__(message)
+        self.status_code = status_code
 
 
 class _OperationContext:
@@ -727,9 +756,7 @@ async def _probe_entity(
             # Also resolve query params that have a matching scoping or config
             # key, so explicit config values take precedence over defaults.
             for qp in endpoint.query_params:
-                if qp not in params_needing_resolution and (
-                    qp in self._scoping_index or qp in self.config_values
-                ):
+                if qp not in params_needing_resolution and (qp in self._scoping_index or qp in self.config_values):
                     params_needing_resolution.append(qp)
             if params_needing_resolution:
                 try:
@@ -744,7 +771,7 @@ async def _probe_entity(
                 except ParamResolutionError as exc:
                     return {
                         "entity": entity_name,
-                        "status": CHECK_STATUS_SKIPPED,
+                        "status": CHECK_STATUS_UNHEALTHY,
                         "error": str(exc),
                         "status_code": None,
                         "checked_action": action.value,
@@ -846,7 +873,10 @@ async def _resolve_path_params(
                         parent_params,
                     )
                 except Exception as exc:
-                    raise ParamResolutionError(f"Parent entity '{parent_entity_name}' probe failed: {exc}") from exc
+                    raise ParentProbeError(
+                        f"Parent entity '{parent_entity_name}' probe failed: {exc}",
+                        status_code=getattr(exc, "status_code", None),
+                    ) from exc
                 records = result.data if isinstance(result.data, list) else []
                 if not records:
                     raise ParamResolutionError(f"Parent entity '{parent_entity_name}' returned no records")

connectors/sendgrid/airbyte_agent_sendgrid/models.py

@@ -145,6 +145,14 @@ class CampaignsList(BaseModel):
     result: Union[list[Campaign], Any] = Field(default=None)
     metadata: Union[CampaignsListMetadata, Any] = Field(default=None, alias="_metadata")
 
+class SingleSendSendTo(BaseModel):
+    """Recipients configuration"""
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    list_ids: Union[list[str] | None, Any] = Field(default=None)
+    segment_ids: Union[list[str] | None, Any] = Field(default=None)
+    all: Union[bool, Any] = Field(default=None)
+
 class SingleSendEmailConfig(BaseModel):
     """Email configuration details"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)
@@ -160,14 +168,6 @@ class SingleSendEmailConfig(BaseModel):
     sender_id: Union[int | None, Any] = Field(default=None)
     ip_pool: Union[str | None, Any] = Field(default=None)
 
-class SingleSendSendTo(BaseModel):
-    """Recipients configuration"""
-    model_config = ConfigDict(extra="allow", populate_by_name=True)
-
-    list_ids: Union[list[str] | None, Any] = Field(default=None)
-    segment_ids: Union[list[str] | None, Any] = Field(default=None)
-    all: Union[bool, Any] = Field(default=None)
-
 class SingleSend(BaseModel):
     """A SendGrid single send"""
     model_config = ConfigDict(extra="allow", populate_by_name=True)

connectors/sendgrid/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "airbyte-agent-sendgrid"
-version = "0.1.22"
+version = "0.1.23"
 description = "Airbyte Sendgrid Connector for AI platforms"
 readme = "README.md"
 requires-python = ">=3.13"