linkedapi 1.0.2__tar.gz → 1.1.0__tar.gz

{linkedapi-1.0.2 → linkedapi-1.1.0}/.gitignore

@@ -6,4 +6,5 @@ dist/
 .ruff_cache/
 .pytest_cache/
 .venv/
+uv.lock
 build/

{linkedapi-1.0.2 → linkedapi-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linkedapi
-Version: 1.0.2
+Version: 1.1.0
 Summary: Official synchronous Python SDK for Linked API.
 Project-URL: Homepage, https://linkedapi.io
 Project-URL: Repository, https://github.com/Linked-API/linkedapi-python

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/__init__.py

@@ -3,6 +3,7 @@ from linkedapi.admin import (
     AdminHttpClient,
     AdminLimits,
     AdminSubscription,
+    AdminWebhooks,
     LinkedApiAdmin,
 )
 from linkedapi.client import LinkedApi
@@ -64,8 +65,9 @@ from linkedapi.operations import (
 )
 from linkedapi.types import *  # noqa: F403
 from linkedapi.types import __all__ as _types_all
+from linkedapi.webhooks import parse_webhook_event
 
-__version__ = "1.0.2"
+__version__ = "1.1.0"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -74,6 +76,7 @@ __all__ = [
     "AdminHttpClient",
     "AdminLimits",
     "AdminSubscription",
+    "AdminWebhooks",
     "ActionConfig",
     "ArrayWorkflowMapper",
     "BaseMapper",
@@ -129,5 +132,6 @@ __all__ = [
     "VoidWorkflowMapper",
     "WithdrawConnectionRequest",
     "__version__",
+    "parse_webhook_event",
     "poll_workflow_result",
 ]

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/admin/__init__.py

@@ -3,11 +3,13 @@ from linkedapi.admin.admin import LinkedApiAdmin
 from linkedapi.admin.http_client import AdminHttpClient
 from linkedapi.admin.limits import AdminLimits
 from linkedapi.admin.subscription import AdminSubscription
+from linkedapi.admin.webhooks import AdminWebhooks
 
 __all__ = [
     "AdminAccounts",
     "AdminHttpClient",
     "AdminLimits",
     "AdminSubscription",
+    "AdminWebhooks",
     "LinkedApiAdmin",
 ]

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/admin/accounts.py

@@ -11,10 +11,14 @@ from linkedapi.types.admin import (
     CancelConnectionSessionParams,
     ConnectionSessionResult,
     CreateConnectionSessionResult,
+    CreateReconnectionSessionParams,
+    CreateReconnectionSessionResult,
     DisconnectParams,
     GetConnectionSessionParams,
     RegenerateTokenParams,
     RegenerateTokenResult,
+    ReparseAccountInfoParams,
+    ReparseAccountInfoResult,
 )
 
 TModel = TypeVar("TModel", bound=BaseModel)
@@ -30,6 +34,14 @@ class AdminAccounts:
     def disconnect(self, params: DisconnectParams) -> None:
         self._post_void("/admin/accounts.disconnect", "Failed to disconnect account", params)
 
+    def reparse_account_info(self, params: ReparseAccountInfoParams) -> ReparseAccountInfoResult:
+        return self._post_result(
+            "/admin/accounts.reparseAccountInfo",
+            ReparseAccountInfoResult,
+            "Failed to reparse account info",
+            params,
+        )
+
     def regenerate_identification_token(
         self,
         params: RegenerateTokenParams,
@@ -48,6 +60,17 @@ class AdminAccounts:
             "Failed to create connection session",
         )
 
+    def create_reconnection_session(
+        self,
+        params: CreateReconnectionSessionParams,
+    ) -> CreateReconnectionSessionResult:
+        return self._post_result(
+            "/admin/accounts.createReconnectionSession",
+            CreateReconnectionSessionResult,
+            "Failed to create reconnection session",
+            params,
+        )
+
     def get_connection_session(
         self,
         params: GetConnectionSessionParams,

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/admin/admin.py

@@ -6,12 +6,13 @@ from linkedapi.admin.accounts import AdminAccounts
 from linkedapi.admin.http_client import AdminHttpClient
 from linkedapi.admin.limits import AdminLimits
 from linkedapi.admin.subscription import AdminSubscription
+from linkedapi.admin.webhooks import AdminWebhooks
 from linkedapi.http import HttpClient
 from linkedapi.types.admin import AdminConfig
 
 
 class LinkedApiAdmin:
-    """Admin SDK for Linked API subscription, account, and limit management."""
+    """Admin SDK for Linked API subscription, account, limit, and webhook management."""
 
     def __init__(self, config: AdminConfig | HttpClient[Any]) -> None:
         http_client = (
@@ -20,3 +21,4 @@ class LinkedApiAdmin:
         self.subscription = AdminSubscription(http_client)
         self.accounts = AdminAccounts(http_client)
         self.limits = AdminLimits(http_client)
+        self.webhooks = AdminWebhooks(http_client)

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/admin/subscription.py

@@ -7,11 +7,8 @@ from pydantic import BaseModel
 from linkedapi.errors import LinkedApiError
 from linkedapi.http import HttpClient
 from linkedapi.types.admin import (
-    BillingLinkResult,
-    CancelResult,
     SetSeatsParams,
     SetSeatsResult,
-    SubscriptionPricingResult,
     SubscriptionSeatsResult,
     SubscriptionStatus,
 )
@@ -33,26 +30,11 @@ class AdminSubscription:
             "/admin/subscription.getSeats", SubscriptionSeatsResult, "Failed to get seats"
         )
 
-    def get_pricing(self) -> SubscriptionPricingResult:
-        return self._post_result(
-            "/admin/subscription.getPricing", SubscriptionPricingResult, "Failed to get pricing"
-        )
-
     def set_seats(self, params: SetSeatsParams) -> SetSeatsResult:
         return self._post_result(
             "/admin/subscription.setSeats", SetSeatsResult, "Failed to set seats", params
         )
 
-    def get_billing_link(self) -> BillingLinkResult:
-        return self._post_result(
-            "/admin/subscription.getBillingLink", BillingLinkResult, "Failed to get billing link"
-        )
-
-    def cancel(self) -> CancelResult:
-        return self._post_result(
-            "/admin/subscription.cancel", CancelResult, "Failed to cancel subscription"
-        )
-
     def _post_result(
         self,
         path: str,

linkedapi-1.1.0/linkedapi/admin/webhooks.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from typing import Any
+
+from linkedapi.errors import LinkedApiError
+from linkedapi.http import HttpClient
+from linkedapi.types.webhooks import (
+    DeleteWebhookParams,
+    ReplayWebhookDeliveryParams,
+    SetWebhookParams,
+    SetWebhookPayloadModeParams,
+    WebhookDelivery,
+    WebhookSubscription,
+)
+
+
+class AdminWebhooks:
+    """Manage the client's registered outbound webhook and inspect recent deliveries.
+
+    A client may hold at most one active webhook. It receives every event Linked API emits
+    (workflow lifecycle + account status changes); filter by the event ``type`` on your receiver.
+    """
+
+    def __init__(self, http_client: HttpClient[Any]) -> None:
+        self.http_client = http_client
+
+    def set(self, params: SetWebhookParams) -> WebhookSubscription:
+        result = self._post_result("/admin/webhook.set", "Failed to set webhook", params)
+        return WebhookSubscription.model_validate(result["webhook"])
+
+    def get(self) -> list[WebhookSubscription]:
+        result = self._post_result("/admin/webhook.get", "Failed to get webhooks")
+        return [WebhookSubscription.model_validate(item) for item in result["webhooks"]]
+
+    def set_payload_mode(self, params: SetWebhookPayloadModeParams) -> WebhookSubscription:
+        result = self._post_result(
+            "/admin/webhook.setPayloadMode",
+            "Failed to set webhook payload mode",
+            params,
+        )
+        return WebhookSubscription.model_validate(result["webhook"])
+
+    def delete(self, params: DeleteWebhookParams) -> None:
+        self._post_void("/admin/webhook.delete", "Failed to delete webhook", params)
+
+    def deliveries(self) -> list[WebhookDelivery]:
+        result = self._post_result("/admin/webhook.deliveries", "Failed to get webhook deliveries")
+        return [WebhookDelivery.model_validate(item) for item in result["deliveries"]]
+
+    def replay_delivery(self, params: ReplayWebhookDeliveryParams) -> None:
+        self._post_void(
+            "/admin/webhook.replayDelivery",
+            "Failed to replay webhook delivery",
+            params,
+        )
+
+    def send_test(self) -> None:
+        self._post_void("/admin/webhook.sendTest", "Failed to send test webhook")
+
+    def _post_result(
+        self,
+        path: str,
+        default_message: str,
+        params: Any | None = None,
+    ) -> dict[str, Any]:
+        response = self.http_client.post(path, params)
+        if response.success and response.result is not None:
+            result: dict[str, Any] = response.result
+            return result
+        raise LinkedApiError(
+            response.error.type if response.error else "httpError",
+            response.error.message if response.error else default_message,
+        )
+
+    def _post_void(self, path: str, default_message: str, params: Any | None = None) -> None:
+        response = self.http_client.post(path, params)
+        if response.success:
+            return
+        raise LinkedApiError(
+            response.error.type if response.error else "httpError",
+            response.error.message if response.error else default_message,
+        )

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/errors.py

@@ -9,6 +9,8 @@ LinkedApiActionErrorType = Literal[
     "alreadyPending",
     "alreadyConnected",
     "emailRequired",
+    "noteTooLong",
+    "noteLimitExceeded",
     "requestNotAllowed",
     "notPending",
     "retrievingNotAllowed",
@@ -29,6 +31,8 @@ LINKED_API_ACTION_ERROR_TYPES: tuple[str, ...] = (
     "alreadyPending",
     "alreadyConnected",
     "emailRequired",
+    "noteTooLong",
+    "noteLimitExceeded",
     "requestNotAllowed",
     "notPending",
     "retrievingNotAllowed",

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/types/__init__.py

@@ -4,15 +4,14 @@ from linkedapi.types.admin import (
     AdminAccount,
     AdminAccountStatus,
     AdminConfig,
-    BillingLinkResult,
     BillingPeriod,
     CancelConnectionSessionParams,
-    CancelResult,
     ConnectionSession,
     ConnectionSessionResult,
     ConnectionSessionStatus,
     CreateConnectionSessionResult,
-    Currency,
+    CreateReconnectionSessionParams,
+    CreateReconnectionSessionResult,
     DeleteLimitEntry,
     DeleteLimitsParams,
     DisconnectParams,
@@ -28,6 +27,8 @@ from linkedapi.types.admin import (
     PendingConnectionSession,
     RegenerateTokenParams,
     RegenerateTokenResult,
+    ReparseAccountInfoParams,
+    ReparseAccountInfoResult,
     ResetLimitsParams,
     SeatType,
     SetLimitEntry,
@@ -35,8 +36,6 @@ from linkedapi.types.admin import (
     SetSeatsParams,
     SetSeatsResult,
     SetSeatsStatus,
-    SubscriptionPricingResult,
-    SubscriptionProduct,
     SubscriptionSeat,
     SubscriptionSeatsResult,
     SubscriptionStatus,
@@ -179,6 +178,26 @@ from linkedapi.types.statistics import (
     RetrievePerformanceResult,
     RetrieveSSIResult,
 )
+from linkedapi.types.webhooks import (
+    AccountWebhookEvent,
+    AccountWebhookEventData,
+    AccountWebhookStatus,
+    DeleteWebhookParams,
+    ReplayWebhookDeliveryParams,
+    SetWebhookParams,
+    SetWebhookPayloadModeParams,
+    WebhookDelivery,
+    WebhookDeliveryStatus,
+    WebhookEvent,
+    WebhookEventType,
+    WebhookPayloadMode,
+    WebhookSubscription,
+    WebhookTestEvent,
+    WebhookTestEventData,
+    WorkflowWebhookEvent,
+    WorkflowWebhookEventData,
+    WorkflowWebhookStatus,
+)
 from linkedapi.types.workflow import (
     LinkedApiActionError,
     WorkflowCancelResponse,
@@ -195,6 +214,9 @@ from linkedapi.types.workflow import (
 
 __all__ = [
     "AccountInfo",
+    "AccountWebhookEvent",
+    "AccountWebhookEventData",
+    "AccountWebhookStatus",
     "AccountsResult",
     "AdminAccount",
     "AdminAccountStatus",
@@ -210,10 +232,8 @@ __all__ = [
     "BaseFetchPersonParamsWide",
     "BaseFetchPostParams",
     "BaseFetchPostParamsWide",
-    "BillingLinkResult",
     "BillingPeriod",
     "CancelConnectionSessionParams",
-    "CancelResult",
     "CheckConnectionStatusParams",
     "CheckConnectionStatusResult",
     "Comment",
@@ -231,9 +251,11 @@ __all__ = [
     "CreatePostAttachment",
     "CreatePostParams",
     "CreatePostResult",
-    "Currency",
+    "CreateReconnectionSessionParams",
+    "CreateReconnectionSessionResult",
     "DeleteLimitEntry",
     "DeleteLimitsParams",
+    "DeleteWebhookParams",
     "DisconnectParams",
     "EmploymentType",
     "FetchCompanyParams",
@@ -315,6 +337,9 @@ __all__ = [
     "RegenerateTokenParams",
     "RegenerateTokenResult",
     "RemoveConnectionParams",
+    "ReparseAccountInfoParams",
+    "ReparseAccountInfoResult",
+    "ReplayWebhookDeliveryParams",
     "ResetLimitsParams",
     "RetrieveConnectionsFilter",
     "RetrieveConnectionsParams",
@@ -341,17 +366,25 @@ __all__ = [
     "SetSeatsParams",
     "SetSeatsResult",
     "SetSeatsStatus",
+    "SetWebhookParams",
+    "SetWebhookPayloadModeParams",
     "StCompanyDm",
     "StCompanyEmployee",
     "StCompanyEmployeesFilter",
     "StCompanyEmployeesRetrievalConfig",
-    "SubscriptionPricingResult",
-    "SubscriptionProduct",
     "SubscriptionSeat",
     "SubscriptionSeatsResult",
     "SubscriptionStatus",
     "SubscriptionStatusValue",
     "SyncConversationParams",
+    "WebhookDelivery",
+    "WebhookDeliveryStatus",
+    "WebhookEvent",
+    "WebhookEventType",
+    "WebhookPayloadMode",
+    "WebhookSubscription",
+    "WebhookTestEvent",
+    "WebhookTestEventData",
     "WithdrawConnectionRequestParams",
     "WorkflowCancelResponse",
     "WorkflowCompletion",
@@ -363,6 +396,9 @@ __all__ = [
     "WorkflowResponse",
     "WorkflowStartedResponse",
     "WorkflowStatus",
+    "WorkflowWebhookEvent",
+    "WorkflowWebhookEventData",
+    "WorkflowWebhookStatus",
     "YearsOfExperience",
     "dump_model_by_name",
     "serialize_model",

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/types/admin/__init__.py

@@ -7,11 +7,15 @@ from linkedapi.types.admin.accounts import (
     ConnectionSessionResult,
     ConnectionSessionStatus,
     CreateConnectionSessionResult,
+    CreateReconnectionSessionParams,
+    CreateReconnectionSessionResult,
     DisconnectParams,
     GetConnectionSessionParams,
     PendingConnectionSession,
     RegenerateTokenParams,
     RegenerateTokenResult,
+    ReparseAccountInfoParams,
+    ReparseAccountInfoResult,
 )
 from linkedapi.types.admin.config import AdminConfig
 from linkedapi.types.admin.limits import (
@@ -30,16 +34,11 @@ from linkedapi.types.admin.limits import (
     SetLimitsParams,
 )
 from linkedapi.types.admin.subscription import (
-    BillingLinkResult,
     BillingPeriod,
-    CancelResult,
-    Currency,
     SeatType,
     SetSeatsParams,
     SetSeatsResult,
     SetSeatsStatus,
-    SubscriptionPricingResult,
-    SubscriptionProduct,
     SubscriptionSeat,
     SubscriptionSeatsResult,
     SubscriptionStatus,
@@ -51,15 +50,14 @@ __all__ = [
     "AdminAccount",
     "AdminAccountStatus",
     "AdminConfig",
-    "BillingLinkResult",
     "BillingPeriod",
     "CancelConnectionSessionParams",
-    "CancelResult",
     "ConnectionSession",
     "ConnectionSessionResult",
     "ConnectionSessionStatus",
     "CreateConnectionSessionResult",
-    "Currency",
+    "CreateReconnectionSessionParams",
+    "CreateReconnectionSessionResult",
     "DeleteLimitEntry",
     "DeleteLimitsParams",
     "DisconnectParams",
@@ -75,6 +73,8 @@ __all__ = [
     "PendingConnectionSession",
     "RegenerateTokenParams",
     "RegenerateTokenResult",
+    "ReparseAccountInfoParams",
+    "ReparseAccountInfoResult",
     "ResetLimitsParams",
     "SeatType",
     "SetLimitEntry",
@@ -82,8 +82,6 @@ __all__ = [
     "SetSeatsParams",
     "SetSeatsResult",
     "SetSeatsStatus",
-    "SubscriptionPricingResult",
-    "SubscriptionProduct",
     "SubscriptionSeat",
     "SubscriptionSeatsResult",
     "SubscriptionStatus",

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/types/admin/accounts.py

@@ -20,10 +20,15 @@ ConnectionSessionStatus = Literal[
 class AdminAccount(LinkedApiModel):
     id: str | None = None
     name: str | None = None
+    url: str | None = None
+    avatar_url: str | None = None
+    headline: str | None = None
     country_code: str | None = None
     identification_token: str | None = None
     status: AdminAccountStatus | None = None
     connected_at: str | None = None
+    reconnection_session_id: str | None = None
+    reconnection_link: str | None = None
 
 
 class PendingConnectionSession(LinkedApiModel):
@@ -40,6 +45,14 @@ class DisconnectParams(LinkedApiModel):
     account_id: str
 
 
+class ReparseAccountInfoParams(LinkedApiModel):
+    account_id: str
+
+
+class ReparseAccountInfoResult(LinkedApiModel):
+    workflow_id: str | None = None
+
+
 class RegenerateTokenParams(LinkedApiModel):
     account_id: str
 
@@ -53,6 +66,15 @@ class CreateConnectionSessionResult(LinkedApiModel):
     connection_link: str | None = None
 
 
+class CreateReconnectionSessionParams(LinkedApiModel):
+    account_id: str
+
+
+class CreateReconnectionSessionResult(LinkedApiModel):
+    reconnection_session_id: str | None = None
+    reconnection_link: str | None = None
+
+
 class GetConnectionSessionParams(LinkedApiModel):
     session_id: str
 

{linkedapi-1.0.2 → linkedapi-1.1.0}/linkedapi/types/admin/subscription.py

@@ -7,7 +7,6 @@ from linkedapi.types.base import LinkedApiModel
 SubscriptionStatusValue = Literal["active", "trialing", "past_due", "canceled"]
 SeatType = Literal["core", "plus"]
 BillingPeriod = Literal["month", "year"]
-Currency = Literal["usd", "eur"]
 SetSeatsStatus = Literal["complete", "processing"]
 
 
@@ -23,14 +22,6 @@ class SubscriptionSeat(LinkedApiModel):
     billing_period: BillingPeriod | None = None
 
 
-class SubscriptionProduct(LinkedApiModel):
-    id: str | None = None
-    seat_type: SeatType | None = None
-    billing_period: BillingPeriod | None = None
-    unit_price: int | None = None
-    currency: Currency | None = None
-
-
 class SetSeatsParams(LinkedApiModel):
     quantity: int
     seat_type: SeatType
@@ -42,17 +33,5 @@ class SetSeatsResult(LinkedApiModel):
     payment_link: str | None = None
 
 
-class BillingLinkResult(LinkedApiModel):
-    stripe_link: str | None = None
-
-
-class CancelResult(LinkedApiModel):
-    cancel_at_date: str | None = None
-
-
 class SubscriptionSeatsResult(LinkedApiModel):
     seats: list[SubscriptionSeat] | None = None
-
-
-class SubscriptionPricingResult(LinkedApiModel):
-    products: list[SubscriptionProduct] | None = None

linkedapi-1.1.0/linkedapi/types/webhooks.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+from typing import Any, Literal
+
+from linkedapi.types.base import LinkedApiModel
+
+WebhookPayloadMode = Literal["thin", "fat"]
+WebhookEventType = Literal[
+    "workflow.created",
+    "workflow.started",
+    "workflow.completed",
+    "account.active",
+    "account.reconnectionRequired",
+    "account.frozen",
+    "account.deleted",
+    "webhook.test",
+]
+WebhookDeliveryStatus = Literal["pending", "delivering", "success", "failed"]
+WorkflowWebhookStatus = Literal["pending", "running", "completed", "failed"]
+AccountWebhookStatus = Literal["active", "reconnection_required", "frozen", "deleted"]
+
+
+class WebhookSubscription(LinkedApiModel):
+    id: str | None = None
+    url: str | None = None
+    payload_mode: WebhookPayloadMode | None = None
+    is_active: bool | None = None
+    created_at: str | None = None
+
+
+class WebhookDelivery(LinkedApiModel):
+    id: str | None = None
+    event_type: WebhookEventType | None = None
+    event_id: str | None = None
+    status: WebhookDeliveryStatus | None = None
+    attempts: int | None = None
+    response_status_code: int | None = None
+    last_error: str | None = None
+    created_at: str | None = None
+    updated_at: str | None = None
+
+
+class SetWebhookParams(LinkedApiModel):
+    url: str
+    payload_mode: WebhookPayloadMode | None = None
+
+
+class SetWebhookPayloadModeParams(LinkedApiModel):
+    id: str
+    payload_mode: WebhookPayloadMode
+
+
+class DeleteWebhookParams(LinkedApiModel):
+    id: str
+
+
+class ReplayWebhookDeliveryParams(LinkedApiModel):
+    delivery_id: str
+
+
+class WorkflowWebhookEventData(LinkedApiModel):
+    workflow_id: str | None = None
+    account_id: str | None = None
+    status: WorkflowWebhookStatus | None = None
+    # Present only on workflow.completed delivered in `fat` payload mode; in `thin` mode fetch the
+    # result via the workflow API by workflow_id.
+    result: Any | None = None
+
+
+class WorkflowWebhookEvent(LinkedApiModel):
+    id: str
+    type: Literal["workflow.created", "workflow.started", "workflow.completed"]
+    created_at: str | None = None
+    data: WorkflowWebhookEventData
+
+
+class AccountWebhookEventData(LinkedApiModel):
+    account_id: str | None = None
+    status: AccountWebhookStatus | None = None
+
+
+class AccountWebhookEvent(LinkedApiModel):
+    id: str
+    type: Literal[
+        "account.active",
+        "account.reconnectionRequired",
+        "account.frozen",
+        "account.deleted",
+    ]
+    created_at: str | None = None
+    data: AccountWebhookEventData
+
+
+class WebhookTestEventData(LinkedApiModel):
+    message: str | None = None
+
+
+class WebhookTestEvent(LinkedApiModel):
+    id: str
+    type: Literal["webhook.test"]
+    created_at: str | None = None
+    data: WebhookTestEventData
+
+
+WebhookEvent = WorkflowWebhookEvent | AccountWebhookEvent | WebhookTestEvent

linkedapi-1.1.0/linkedapi/webhooks/__init__.py

@@ -0,0 +1,3 @@
+from linkedapi.webhooks.parse import parse_webhook_event
+
+__all__ = ["parse_webhook_event"]

linkedapi-1.1.0/linkedapi/webhooks/parse.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+import json
+
+from linkedapi.types.webhooks import (
+    AccountWebhookEvent,
+    WebhookEvent,
+    WebhookTestEvent,
+    WorkflowWebhookEvent,
+)
+
+
+def parse_webhook_event(raw_body: str | bytes) -> WebhookEvent:
+    """Parse a raw webhook request body into a typed Linked API event.
+
+    Pass the raw HTTP body (``str`` or ``bytes``) exactly as received, then branch on the
+    returned event's ``type``.
+
+    Raises:
+        ValueError: when the body is not valid JSON or is missing the ``id`` / ``type`` fields,
+            or carries an unknown event type.
+    """
+    text = raw_body.decode("utf-8") if isinstance(raw_body, (bytes, bytearray)) else raw_body
+
+    try:
+        parsed = json.loads(text)
+    except (ValueError, TypeError) as error:
+        msg = "Invalid webhook payload: body is not valid JSON"
+        raise ValueError(msg) from error
+
+    if (
+        not isinstance(parsed, dict)
+        or not isinstance(parsed.get("id"), str)
+        or not isinstance(parsed.get("type"), str)
+    ):
+        msg = 'Invalid webhook payload: missing "id" or "type"'
+        raise ValueError(msg)
+
+    event_type: str = parsed["type"]
+    if event_type.startswith("workflow."):
+        return WorkflowWebhookEvent.model_validate(parsed)
+    if event_type.startswith("account."):
+        return AccountWebhookEvent.model_validate(parsed)
+    if event_type == "webhook.test":
+        return WebhookTestEvent.model_validate(parsed)
+
+    msg = f"Unknown webhook event type: {event_type}"
+    raise ValueError(msg)

{linkedapi-1.0.2 → linkedapi-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "linkedapi"
-version = "1.0.2"
+version = "1.1.0"
 description = "Official synchronous Python SDK for Linked API."
 readme = "README.md"
 requires-python = ">=3.10"

{linkedapi-1.0.2 → linkedapi-1.1.0}/tests/test_admin.py

@@ -8,6 +8,7 @@ from linkedapi import (
     AdminConfig,
     AdminHttpClient,
     CancelConnectionSessionParams,
+    CreateReconnectionSessionParams,
     DeleteLimitEntry,
     DeleteLimitsParams,
     DisconnectParams,
@@ -16,6 +17,7 @@ from linkedapi import (
     GetLimitsUsageParams,
     LinkedApiAdmin,
     RegenerateTokenParams,
+    ReparseAccountInfoParams,
     ResetLimitsParams,
     SetLimitEntry,
     SetLimitsParams,
@@ -59,14 +61,16 @@ def test_admin_methods_use_node_paths(requests_mock: requests_mock.Mocker) -> No
             {"status": "active", "eligibleForTrial": False, "cancelAtPeriodEnd": False},
         ),
         ("/admin/subscription.getSeats", {"seats": []}),
-        ("/admin/subscription.getPricing", {"products": []}),
         ("/admin/subscription.setSeats", {"status": "complete"}),
-        ("/admin/subscription.getBillingLink", {"stripeLink": "https://stripe.test"}),
-        ("/admin/subscription.cancel", {"cancelAtDate": "2026-01-01"}),
         ("/admin/accounts.getAll", {"accounts": [], "pendingConnectionSessions": []}),
         ("/admin/accounts.disconnect", None),
+        ("/admin/accounts.reparseAccountInfo", {"workflowId": "workflow-1"}),
         ("/admin/accounts.regenerateIdentificationToken", {"token": "new"}),
         ("/admin/accounts.createConnectionSession", {"sessionId": "s1", "connectionLink": "u"}),
+        (
+            "/admin/accounts.createReconnectionSession",
+            {"reconnectionSessionId": "s2", "reconnectionLink": "u2"},
+        ),
         (
             "/admin/accounts.getConnectionSession",
             {"session": {"sessionId": "s1", "status": "pending", "type": "connect"}},
@@ -87,16 +91,15 @@ def test_admin_methods_use_node_paths(requests_mock: requests_mock.Mocker) -> No
 
     admin.subscription.get_status()
     admin.subscription.get_seats()
-    admin.subscription.get_pricing()
     admin.subscription.set_seats(
         SetSeatsParams(quantity=1, seat_type="core", billing_period="month")
     )
-    admin.subscription.get_billing_link()
-    admin.subscription.cancel()
     admin.accounts.get_all()
     admin.accounts.disconnect(DisconnectParams(account_id="a1"))
+    admin.accounts.reparse_account_info(ReparseAccountInfoParams(account_id="a1"))
     admin.accounts.regenerate_identification_token(RegenerateTokenParams(account_id="a1"))
     admin.accounts.create_connection_session()
+    admin.accounts.create_reconnection_session(CreateReconnectionSessionParams(account_id="a1"))
     admin.accounts.get_connection_session(GetConnectionSessionParams(session_id="s1"))
     admin.accounts.cancel_connection_session(CancelConnectionSessionParams(session_id="s1"))
     admin.limits.get_defaults()

{linkedapi-1.0.2 → linkedapi-1.1.0}/tests/test_errors.py

@@ -35,6 +35,8 @@ def test_error_type_sets_match_node_contract() -> None:
         "alreadyPending",
         "alreadyConnected",
         "emailRequired",
+        "noteTooLong",
+        "noteLimitExceeded",
         "requestNotAllowed",
         "notPending",
         "retrievingNotAllowed",