linkedapi 1.0.2__tar.gz → 1.1.1__tar.gz

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linkedapi
-Version: 1.0.2
+Version: 1.1.1
 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.1}/linkedapi/__init__.py

@@ -3,6 +3,7 @@ from linkedapi.admin import (
     AdminHttpClient,
     AdminLimits,
     AdminSubscription,
+    AdminWebhooks,
     LinkedApiAdmin,
 )
 from linkedapi.client import LinkedApi
@@ -48,6 +49,7 @@ from linkedapi.operations import (
     NvSearchPeople,
     NvSendMessage,
     NvSyncConversation,
+    NvSyncInbox,
     ReactToPost,
     RemoveConnection,
     RetrieveConnections,
@@ -60,12 +62,14 @@ from linkedapi.operations import (
     SendConnectionRequest,
     SendMessage,
     SyncConversation,
+    SyncInbox,
     WithdrawConnectionRequest,
 )
 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.1"
 PredefinedOperation = Operation
 
 __all__ = [
@@ -74,6 +78,7 @@ __all__ = [
     "AdminHttpClient",
     "AdminLimits",
     "AdminSubscription",
+    "AdminWebhooks",
     "ActionConfig",
     "ArrayWorkflowMapper",
     "BaseMapper",
@@ -109,6 +114,7 @@ __all__ = [
     "NvSearchPeople",
     "NvSendMessage",
     "NvSyncConversation",
+    "NvSyncInbox",
     "Operation",
     "PredefinedOperation",
     "ReactToPost",
@@ -125,9 +131,11 @@ __all__ = [
     "SendMessage",
     "SimpleWorkflowMapper",
     "SyncConversation",
+    "SyncInbox",
     "ThenWorkflowMapper",
     "VoidWorkflowMapper",
     "WithdrawConnectionRequest",
     "__version__",
+    "parse_webhook_event",
     "poll_workflow_result",
 ]

{linkedapi-1.0.2 → linkedapi-1.1.1}/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.1}/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.1}/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.1}/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.1/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.1}/linkedapi/client.py

@@ -22,6 +22,7 @@ from linkedapi.operations import (
     NvSearchPeople,
     NvSendMessage,
     NvSyncConversation,
+    NvSyncInbox,
     ReactToPost,
     RemoveConnection,
     RetrieveConnections,
@@ -34,10 +35,16 @@ from linkedapi.operations import (
     SendConnectionRequest,
     SendMessage,
     SyncConversation,
+    SyncInbox,
     WithdrawConnectionRequest,
 )
 from linkedapi.types import AccountInfo, LinkedApiActionError, serialize_value
-from linkedapi.types.message import ConversationPollRequest, ConversationPollResult
+from linkedapi.types.message import (
+    ConversationPollRequest,
+    ConversationPollResult,
+    InboxMessage,
+    InboxPollRequest,
+)
 from linkedapi.types.statistics import ApiUsageAction, ApiUsageParams
 
 
@@ -54,6 +61,7 @@ class LinkedApi:
         self.custom_workflow = CustomWorkflow(self.http_client)
         self.send_message = SendMessage(self.http_client)
         self.sync_conversation = SyncConversation(self.http_client)
+        self.sync_inbox = SyncInbox(self.http_client)
         self.check_connection_status = CheckConnectionStatus(self.http_client)
         self.send_connection_request = SendConnectionRequest(self.http_client)
         self.withdraw_connection_request = WithdrawConnectionRequest(self.http_client)
@@ -74,6 +82,7 @@ class LinkedApi:
         self.retrieve_performance = RetrievePerformance(self.http_client)
         self.nv_send_message = NvSendMessage(self.http_client)
         self.nv_sync_conversation = NvSyncConversation(self.http_client)
+        self.nv_sync_inbox = NvSyncInbox(self.http_client)
         self.nv_search_companies = NvSearchCompanies(self.http_client)
         self.nv_search_people = NvSearchPeople(self.http_client)
         self.nv_fetch_company = NvFetchCompany(self.http_client)
@@ -83,6 +92,7 @@ class LinkedApi:
             self.custom_workflow,
             self.send_message,
             self.sync_conversation,
+            self.sync_inbox,
             self.check_connection_status,
             self.send_connection_request,
             self.withdraw_connection_request,
@@ -103,6 +113,7 @@ class LinkedApi:
             self.retrieve_performance,
             self.nv_send_message,
             self.nv_sync_conversation,
+            self.nv_sync_inbox,
             self.nv_search_companies,
             self.nv_search_people,
             self.nv_fetch_company,
@@ -139,6 +150,30 @@ class LinkedApi:
                 )
             raise
 
+    def poll_inbox(
+        self,
+        request: InboxPollRequest | None = None,
+    ) -> MappedResponse[list[InboxMessage]]:
+        """Read the monitored standard or Sales Navigator inbox, newest messages first."""
+
+        payload = serialize_value(request) if request is not None else {}
+        response = self.http_client.post("/inbox/poll", payload)
+        if response.success and response.result is not None:
+            messages = response.result.get("messages", [])
+            return MappedResponse(
+                data=[InboxMessage.model_validate(item) for item in messages],
+                errors=[],
+            )
+        return MappedResponse(
+            data=None,
+            errors=[
+                LinkedApiActionError(
+                    type=response.error.type if response.error else "",
+                    message=response.error.message if response.error else "",
+                ),
+            ],
+        )
+
     def get_account_info(self) -> MappedResponse[AccountInfo]:
         """Retrieve basic information about the current LinkedIn account."""
 

{linkedapi-1.0.2 → linkedapi-1.1.1}/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.1}/linkedapi/operations/__init__.py

@@ -12,6 +12,7 @@ from linkedapi.operations.nv_search_companies import NvSearchCompanies
 from linkedapi.operations.nv_search_people import NvSearchPeople
 from linkedapi.operations.nv_send_message import NvSendMessage
 from linkedapi.operations.nv_sync_conversation import NvSyncConversation
+from linkedapi.operations.nv_sync_inbox import NvSyncInbox
 from linkedapi.operations.react_to_post import ReactToPost
 from linkedapi.operations.remove_connection import RemoveConnection
 from linkedapi.operations.retrieve_connections import RetrieveConnections
@@ -24,6 +25,7 @@ from linkedapi.operations.search_people import SearchPeople
 from linkedapi.operations.send_connection_request import SendConnectionRequest
 from linkedapi.operations.send_message import SendMessage
 from linkedapi.operations.sync_conversation import SyncConversation
+from linkedapi.operations.sync_inbox import SyncInbox
 from linkedapi.operations.withdraw_connection_request import WithdrawConnectionRequest
 
 __all__ = [
@@ -47,6 +49,7 @@ __all__ = [
     "NvSearchPeople",
     "NvSendMessage",
     "NvSyncConversation",
+    "NvSyncInbox",
     "ReactToPost",
     "RemoveConnection",
     "RetrieveConnections",
@@ -59,5 +62,6 @@ __all__ = [
     "SendConnectionRequest",
     "SendMessage",
     "SyncConversation",
+    "SyncInbox",
     "WithdrawConnectionRequest",
 ]

linkedapi-1.1.1/linkedapi/operations/nv_sync_inbox.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import VoidWorkflowMapper
+from linkedapi.types import NvSyncInboxParams
+
+
+class NvSyncInbox(Operation[NvSyncInboxParams, None]):
+    """Enable whole-inbox monitoring for Sales Navigator conversations."""
+
+    operation_name = "nvSyncInbox"
+    mapper = VoidWorkflowMapper[NvSyncInboxParams]("nv.syncInbox")

linkedapi-1.1.1/linkedapi/operations/sync_inbox.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from linkedapi.core import Operation
+from linkedapi.mappers import VoidWorkflowMapper
+from linkedapi.types import SyncInboxParams
+
+
+class SyncInbox(Operation[SyncInboxParams, None]):
+    """Enable whole-inbox monitoring for standard LinkedIn conversations."""
+
+    operation_name = "syncInbox"
+    mapper = VoidWorkflowMapper[SyncInboxParams]("st.syncInbox")

{linkedapi-1.0.2 → linkedapi-1.1.1}/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,
@@ -102,12 +101,16 @@ from linkedapi.types.message import (
     ConversationPollRequest,
     ConversationPollResult,
     ConversationType,
+    InboxMessage,
+    InboxPollRequest,
     Message,
     MessageSender,
     NvSendMessageParams,
     NvSyncConversationParams,
+    NvSyncInboxParams,
     SendMessageParams,
     SyncConversationParams,
+    SyncInboxParams,
 )
 from linkedapi.types.params import BaseActionParams, LimitParams, LimitSinceParams
 from linkedapi.types.person import (
@@ -179,6 +182,28 @@ from linkedapi.types.statistics import (
     RetrievePerformanceResult,
     RetrieveSSIResult,
 )
+from linkedapi.types.webhooks import (
+    AccountWebhookEvent,
+    AccountWebhookEventData,
+    AccountWebhookStatus,
+    DeleteWebhookParams,
+    MessageWebhookEvent,
+    MessageWebhookEventData,
+    ReplayWebhookDeliveryParams,
+    SetWebhookParams,
+    SetWebhookPayloadModeParams,
+    WebhookDelivery,
+    WebhookDeliveryStatus,
+    WebhookEvent,
+    WebhookEventType,
+    WebhookPayloadMode,
+    WebhookSubscription,
+    WebhookTestEvent,
+    WebhookTestEventData,
+    WorkflowWebhookEvent,
+    WorkflowWebhookEventData,
+    WorkflowWebhookStatus,
+)
 from linkedapi.types.workflow import (
     LinkedApiActionError,
     WorkflowCancelResponse,
@@ -195,6 +220,9 @@ from linkedapi.types.workflow import (
 
 __all__ = [
     "AccountInfo",
+    "AccountWebhookEvent",
+    "AccountWebhookEventData",
+    "AccountWebhookStatus",
     "AccountsResult",
     "AdminAccount",
     "AdminAccountStatus",
@@ -210,10 +238,8 @@ __all__ = [
     "BaseFetchPersonParamsWide",
     "BaseFetchPostParams",
     "BaseFetchPostParamsWide",
-    "BillingLinkResult",
     "BillingPeriod",
     "CancelConnectionSessionParams",
-    "CancelResult",
     "CheckConnectionStatusParams",
     "CheckConnectionStatusResult",
     "Comment",
@@ -231,9 +257,11 @@ __all__ = [
     "CreatePostAttachment",
     "CreatePostParams",
     "CreatePostResult",
-    "Currency",
+    "CreateReconnectionSessionParams",
+    "CreateReconnectionSessionResult",
     "DeleteLimitEntry",
     "DeleteLimitsParams",
+    "DeleteWebhookParams",
     "DisconnectParams",
     "EmploymentType",
     "FetchCompanyParams",
@@ -247,6 +275,8 @@ __all__ = [
     "GetConnectionSessionParams",
     "GetLimitsParams",
     "GetLimitsUsageParams",
+    "InboxMessage",
+    "InboxPollRequest",
     "Job",
     "JobCurrency",
     "JobDatePosted",
@@ -271,6 +301,8 @@ __all__ = [
     "MaxAnnualRevenue",
     "Message",
     "MessageSender",
+    "MessageWebhookEvent",
+    "MessageWebhookEventData",
     "MinAnnualRevenue",
     "NvBaseFetchCompanyParams",
     "NvBaseFetchCompanyParamsWide",
@@ -291,6 +323,7 @@ __all__ = [
     "NvSearchPeopleResult",
     "NvSendMessageParams",
     "NvSyncConversationParams",
+    "NvSyncInboxParams",
     "PendingConnectionSession",
     "Person",
     "PersonEducation",
@@ -315,6 +348,9 @@ __all__ = [
     "RegenerateTokenParams",
     "RegenerateTokenResult",
     "RemoveConnectionParams",
+    "ReparseAccountInfoParams",
+    "ReparseAccountInfoResult",
+    "ReplayWebhookDeliveryParams",
     "ResetLimitsParams",
     "RetrieveConnectionsFilter",
     "RetrieveConnectionsParams",
@@ -341,17 +377,26 @@ __all__ = [
     "SetSeatsParams",
     "SetSeatsResult",
     "SetSeatsStatus",
+    "SetWebhookParams",
+    "SetWebhookPayloadModeParams",
     "StCompanyDm",
     "StCompanyEmployee",
     "StCompanyEmployeesFilter",
     "StCompanyEmployeesRetrievalConfig",
-    "SubscriptionPricingResult",
-    "SubscriptionProduct",
     "SubscriptionSeat",
     "SubscriptionSeatsResult",
     "SubscriptionStatus",
     "SubscriptionStatusValue",
     "SyncConversationParams",
+    "SyncInboxParams",
+    "WebhookDelivery",
+    "WebhookDeliveryStatus",
+    "WebhookEvent",
+    "WebhookEventType",
+    "WebhookPayloadMode",
+    "WebhookSubscription",
+    "WebhookTestEvent",
+    "WebhookTestEventData",
     "WithdrawConnectionRequestParams",
     "WorkflowCancelResponse",
     "WorkflowCompletion",
@@ -363,6 +408,9 @@ __all__ = [
     "WorkflowResponse",
     "WorkflowStartedResponse",
     "WorkflowStatus",
+    "WorkflowWebhookEvent",
+    "WorkflowWebhookEventData",
+    "WorkflowWebhookStatus",
     "YearsOfExperience",
     "dump_model_by_name",
     "serialize_model",