linq-python 0.58.2__tar.gz → 0.59.0__tar.gz

linq_python-0.59.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.59.0"
+}

{linq_python-0.58.2 → linq_python-0.59.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.59.0](https://github.com/linq-team/linq-python/compare/v0.58.2...v0.59.0) (2026-09-26)
+
+
+### Features
+
+* add webhook events for account changes ([54a61b8](https://github.com/linq-team/linq-python/commit/54a61b80a2c7f0e5552419264ad986b35d280839))
+
 ## [0.58.2](https://github.com/linq-team/linq-python/compare/v0.58.1...v0.58.2) (2026-09-26)
 
 

{linq_python-0.58.2 → linq_python-0.59.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.58.2
+Version: 0.59.0
 Summary: The official Python library for the linq-api-v3 API
 Project-URL: Homepage, https://github.com/linq-team/linq-python
 Project-URL: Repository, https://github.com/linq-team/linq-python

{linq_python-0.58.2 → linq_python-0.59.0}/api.md

@@ -400,6 +400,33 @@ from linq.types import (
     PaymentDeclinedWebhookEvent,
     PaymentExpiredWebhookEvent,
     PaymentSucceededWebhookEvent,
+    ZeroDayRetentionUpdatedWebhookEvent,
+    PhoneNumberForwardingUpdatedWebhookEvent,
+    EnvironmentLineMovedWebhookEvent,
+    ContactCardCreatedWebhookEvent,
+    ContactCardUpdatedWebhookEvent,
+    ContactCardDeletedWebhookEvent,
+    APITokenCreatedWebhookEvent,
+    APITokenRenamedWebhookEvent,
+    APITokenExpiryScheduledWebhookEvent,
+    APITokenExpiredWebhookEvent,
+    APITokenActivatedWebhookEvent,
+    APITokenDeletedWebhookEvent,
+    EnvironmentCreatedWebhookEvent,
+    EnvironmentRenamedWebhookEvent,
+    EnvironmentDeletedWebhookEvent,
+    WebhookSubscriptionCreatedWebhookEvent,
+    WebhookSubscriptionDeletedWebhookEvent,
+    WebhookSubscriptionTargetURLChangedWebhookEvent,
+    WebhookSubscriptionEnabledWebhookEvent,
+    WebhookSubscriptionDisabledWebhookEvent,
+    WebhookSubscriptionEventsUpdatedWebhookEvent,
+    WebhookSubscriptionPhoneNumbersUpdatedWebhookEvent,
+    WebhookSubscriptionRoutingHeadersSetWebhookEvent,
+    WebhookSubscriptionRoutingHeadersClearedWebhookEvent,
+    TeamMemberAddedWebhookEvent,
+    TeamMemberSignedInWebhookEvent,
+    TeamMemberSignedOutWebhookEvent,
     UnwrapWebhookEvent,
 )
 ```

{linq_python-0.58.2 → linq_python-0.59.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.58.2"
+version = "0.59.0"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{linq_python-0.58.2 → linq_python-0.59.0}/src/linq/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "linq"
-__version__ = "0.58.2"  # x-release-please-version
+__version__ = "0.59.0"  # x-release-please-version

{linq_python-0.58.2 → linq_python-0.59.0}/src/linq/types/__init__.py

@@ -106,21 +106,33 @@ from .message_update_app_card_params import MessageUpdateAppCardParams as Messag
 from .payment_canceled_webhook_event import PaymentCanceledWebhookEvent as PaymentCanceledWebhookEvent
 from .payment_declined_webhook_event import PaymentDeclinedWebhookEvent as PaymentDeclinedWebhookEvent
 from .reaction_removed_webhook_event import ReactionRemovedWebhookEvent as ReactionRemovedWebhookEvent
+from .api_token_created_webhook_event import APITokenCreatedWebhookEvent as APITokenCreatedWebhookEvent
+from .api_token_deleted_webhook_event import APITokenDeletedWebhookEvent as APITokenDeletedWebhookEvent
+from .api_token_expired_webhook_event import APITokenExpiredWebhookEvent as APITokenExpiredWebhookEvent
+from .api_token_renamed_webhook_event import APITokenRenamedWebhookEvent as APITokenRenamedWebhookEvent
 from .message_delivered_webhook_event import MessageDeliveredWebhookEvent as MessageDeliveredWebhookEvent
 from .participant_added_webhook_event import ParticipantAddedWebhookEvent as ParticipantAddedWebhookEvent
 from .payment_provider_connect_params import PaymentProviderConnectParams as PaymentProviderConnectParams
 from .payment_succeeded_webhook_event import PaymentSucceededWebhookEvent as PaymentSucceededWebhookEvent
 from .poll_vote_removed_webhook_event import PollVoteRemovedWebhookEvent as PollVoteRemovedWebhookEvent
+from .team_member_added_webhook_event import TeamMemberAddedWebhookEvent as TeamMemberAddedWebhookEvent
 from .available_number_retrieve_params import AvailableNumberRetrieveParams as AvailableNumberRetrieveParams
 from .connection_created_webhook_event import ConnectionCreatedWebhookEvent as ConnectionCreatedWebhookEvent
 from .connection_revoked_webhook_event import ConnectionRevokedWebhookEvent as ConnectionRevokedWebhookEvent
 from .message_update_app_card_response import MessageUpdateAppCardResponse as MessageUpdateAppCardResponse
 from .payment_authorized_webhook_event import PaymentAuthorizedWebhookEvent as PaymentAuthorizedWebhookEvent
+from .api_token_activated_webhook_event import APITokenActivatedWebhookEvent as APITokenActivatedWebhookEvent
 from .capability_check_i_message_params import CapabilityCheckIMessageParams as CapabilityCheckIMessageParams
+from .environment_created_webhook_event import EnvironmentCreatedWebhookEvent as EnvironmentCreatedWebhookEvent
+from .environment_deleted_webhook_event import EnvironmentDeletedWebhookEvent as EnvironmentDeletedWebhookEvent
+from .environment_renamed_webhook_event import EnvironmentRenamedWebhookEvent as EnvironmentRenamedWebhookEvent
 from .participant_removed_webhook_event import ParticipantRemovedWebhookEvent as ParticipantRemovedWebhookEvent
 from .payment_provider_connect_response import PaymentProviderConnectResponse as PaymentProviderConnectResponse
 from .poll_reaction_added_webhook_event import PollReactionAddedWebhookEvent as PollReactionAddedWebhookEvent
 from .available_number_retrieve_response import AvailableNumberRetrieveResponse as AvailableNumberRetrieveResponse
+from .contact_card_created_webhook_event import ContactCardCreatedWebhookEvent as ContactCardCreatedWebhookEvent
+from .contact_card_deleted_webhook_event import ContactCardDeletedWebhookEvent as ContactCardDeletedWebhookEvent
+from .contact_card_updated_webhook_event import ContactCardUpdatedWebhookEvent as ContactCardUpdatedWebhookEvent
 from .webhook_subscription_create_params import WebhookSubscriptionCreateParams as WebhookSubscriptionCreateParams
 from .webhook_subscription_list_response import WebhookSubscriptionListResponse as WebhookSubscriptionListResponse
 from .webhook_subscription_update_params import WebhookSubscriptionUpdateParams as WebhookSubscriptionUpdateParams
@@ -128,6 +140,9 @@ from .contact_card_received_webhook_event import ContactCardReceivedWebhookEvent
 from .message_list_messages_thread_params import MessageListMessagesThreadParams as MessageListMessagesThreadParams
 from .phone_number_assigned_webhook_event import PhoneNumberAssignedWebhookEvent as PhoneNumberAssignedWebhookEvent
 from .phone_number_released_webhook_event import PhoneNumberReleasedWebhookEvent as PhoneNumberReleasedWebhookEvent
+from .team_member_signed_in_webhook_event import TeamMemberSignedInWebhookEvent as TeamMemberSignedInWebhookEvent
+from .environment_line_moved_webhook_event import EnvironmentLineMovedWebhookEvent as EnvironmentLineMovedWebhookEvent
+from .team_member_signed_out_webhook_event import TeamMemberSignedOutWebhookEvent as TeamMemberSignedOutWebhookEvent
 from .webhook_subscription_create_response import WebhookSubscriptionCreateResponse as WebhookSubscriptionCreateResponse
 from .chat_background_updated_webhook_event import (
     ChatBackgroundUpdatedWebhookEvent as ChatBackgroundUpdatedWebhookEvent,
@@ -143,12 +158,27 @@ from .location_sharing_stopped_webhook_event import (
 from .message_update_sticker_placement_params import (
     MessageUpdateStickerPlacementParams as MessageUpdateStickerPlacementParams,
 )
+from .api_token_expiry_scheduled_webhook_event import (
+    APITokenExpiryScheduledWebhookEvent as APITokenExpiryScheduledWebhookEvent,
+)
+from .zero_day_retention_updated_webhook_event import (
+    ZeroDayRetentionUpdatedWebhookEvent as ZeroDayRetentionUpdatedWebhookEvent,
+)
 from .message_update_sticker_placement_response import (
     MessageUpdateStickerPlacementResponse as MessageUpdateStickerPlacementResponse,
 )
 from .phone_number_status_updated_webhook_event import (
     PhoneNumberStatusUpdatedWebhookEvent as PhoneNumberStatusUpdatedWebhookEvent,
 )
+from .webhook_subscription_created_webhook_event import (
+    WebhookSubscriptionCreatedWebhookEvent as WebhookSubscriptionCreatedWebhookEvent,
+)
+from .webhook_subscription_deleted_webhook_event import (
+    WebhookSubscriptionDeletedWebhookEvent as WebhookSubscriptionDeletedWebhookEvent,
+)
+from .webhook_subscription_enabled_webhook_event import (
+    WebhookSubscriptionEnabledWebhookEvent as WebhookSubscriptionEnabledWebhookEvent,
+)
 from .chat_background_update_failed_webhook_event import (
     ChatBackgroundUpdateFailedWebhookEvent as ChatBackgroundUpdateFailedWebhookEvent,
 )
@@ -164,3 +194,24 @@ from .chat_typing_indicator_started_webhook_event import (
 from .chat_typing_indicator_stopped_webhook_event import (
     ChatTypingIndicatorStoppedWebhookEvent as ChatTypingIndicatorStoppedWebhookEvent,
 )
+from .webhook_subscription_disabled_webhook_event import (
+    WebhookSubscriptionDisabledWebhookEvent as WebhookSubscriptionDisabledWebhookEvent,
+)
+from .phone_number_forwarding_updated_webhook_event import (
+    PhoneNumberForwardingUpdatedWebhookEvent as PhoneNumberForwardingUpdatedWebhookEvent,
+)
+from .webhook_subscription_events_updated_webhook_event import (
+    WebhookSubscriptionEventsUpdatedWebhookEvent as WebhookSubscriptionEventsUpdatedWebhookEvent,
+)
+from .webhook_subscription_target_url_changed_webhook_event import (
+    WebhookSubscriptionTargetURLChangedWebhookEvent as WebhookSubscriptionTargetURLChangedWebhookEvent,
+)
+from .webhook_subscription_routing_headers_set_webhook_event import (
+    WebhookSubscriptionRoutingHeadersSetWebhookEvent as WebhookSubscriptionRoutingHeadersSetWebhookEvent,
+)
+from .webhook_subscription_phone_numbers_updated_webhook_event import (
+    WebhookSubscriptionPhoneNumbersUpdatedWebhookEvent as WebhookSubscriptionPhoneNumbersUpdatedWebhookEvent,
+)
+from .webhook_subscription_routing_headers_cleared_webhook_event import (
+    WebhookSubscriptionRoutingHeadersClearedWebhookEvent as WebhookSubscriptionRoutingHeadersClearedWebhookEvent,
+)

linq_python-0.59.0/src/linq/types/api_token_activated_webhook_event.py

@@ -0,0 +1,333 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = [
+    "APITokenActivatedWebhookEvent",
+    "Data",
+    "DataActor",
+    "DataAPIToken",
+    "DataChange",
+    "DataChangeName",
+    "DataContactCard",
+    "DataEnvironment",
+    "DataTeamMember",
+    "DataWebhookSubscription",
+]
+
+
+class DataActor(BaseModel):
+    """Who made the change.
+
+    `team_member` carries the member's id, name and email; other types carry no identity. `system` is a change made by Linq, matching "System" on your Activity page. `unknown` means the actor could not be identified.
+    """
+
+    type: Literal["team_member", "api", "system", "unknown"]
+
+    id: Optional[str] = None
+    """Team member's user ID. Only for `team_member`."""
+
+    email: Optional[str] = None
+    """Team member's email. Only for `team_member`."""
+
+    name: Optional[str] = None
+    """Team member's name. Only for `team_member`."""
+
+
+class DataAPIToken(BaseModel):
+    """The API token that changed."""
+
+    id: str
+
+    expires_at: Optional[datetime] = None
+    """When the token expires.
+
+    On `api_token.created`, `api_token.expired` and `api_token.deleted`; absent if
+    it never expires.
+    """
+
+    name: Optional[str] = None
+    """Absent when the token has no name."""
+
+    token_prefix: Optional[str] = None
+    """The token's visible prefix. On `api_token.created` and `api_token.deleted`."""
+
+
+class DataChangeName(BaseModel):
+    """A contact card name change.
+
+    Only on `contact_card.updated`, when the name changed.
+    """
+
+    from_: Optional[str] = FieldInfo(alias="from", default=None)
+    """The name before the change; null when the card had no name."""
+
+    to: Optional[str] = None
+    """The name after the change; null when it was removed."""
+
+
+class DataChange(BaseModel):
+    """
+    The transition an update event describes: `from` is the value before and `to` the value after. Present only on update events (`*.updated`, `*.renamed`, `*_changed`, `api_token.expiry_scheduled`, `environment.line_moved`, `webhook_subscription.routing_headers_*`); created, deleted, enabled, disabled, expired and activated events never carry it. `null` means none: `to: null` means cleared and `from: null` means first set. The value type depends on the event and is given in each event's description. `contact_card.updated` uses `name` instead of `from` and `to`.
+    """
+
+    from_: Optional[object] = FieldInfo(alias="from", default=None)
+    """The value before the change; null when there was none."""
+
+    name: Optional[DataChangeName] = None
+    """A contact card name change.
+
+    Only on `contact_card.updated`, when the name changed.
+    """
+
+    to: Optional[object] = None
+    """The value after the change; null when it was cleared."""
+
+
+class DataContactCard(BaseModel):
+    """The contact card that changed."""
+
+    id: str
+
+    name: Optional[str] = None
+    """Display name. Absent when the card has no name."""
+
+    photo_updated: Optional[bool] = None
+    """True when the photo changed. Only on `contact_card.updated`."""
+
+
+class DataEnvironment(BaseModel):
+    """An environment.
+
+    Production is `{"id": null, "name": "Production", "type": "production"}`; every other environment has an `id` and type `environment`.
+    """
+
+    id: Optional[str] = None
+    """Null for Production."""
+
+    type: Literal["production", "environment"]
+
+    name: Optional[str] = None
+
+
+class DataTeamMember(BaseModel):
+    """The team member the event is about."""
+
+    id: str
+    """The team member's user ID."""
+
+    name: Optional[str] = None
+    """Absent when the member has no name."""
+
+    role: Optional[Literal["admin", "manager", "member"]] = None
+    """Role the member joined with. Only on `team_member.added`."""
+
+
+class DataWebhookSubscription(BaseModel):
+    """The webhook subscription that changed."""
+
+    id: str
+
+    events: Optional[List[str]] = None
+    """Event types it listens for. Only on `webhook_subscription.created`."""
+
+    target_url: Optional[str] = None
+    """Sent without credentials, query string or fragment."""
+
+
+class Data(BaseModel):
+    """A change on your account, the same change shown on your Activity page.
+
+    Every event carries `summary`, `occurred_at`, `actor` and `origin`. The object fields (`api_token`, `webhook_subscription`, `environment`, `contact_card`, `phone_number`, `team_member`) identify what changed; on update events `change` describes the transition. Created and deleted events carry only the object that was created or deleted. Fields are absent when they don't apply; `null` appears only inside `change` and as Production's environment `id`.
+    """
+
+    actor: DataActor
+    """Who made the change.
+
+    `team_member` carries the member's id, name and email; other types carry no
+    identity. `system` is a change made by Linq, matching "System" on your Activity
+    page. `unknown` means the actor could not be identified.
+    """
+
+    occurred_at: datetime
+    """When the change happened."""
+
+    origin: Literal["dashboard", "api", "linq"]
+    """Where the change was made."""
+
+    summary: str
+    """Human-readable label, identical to the Activity page.
+
+    For display only; the wording may change without a new webhook version.
+    """
+
+    api_token: Optional[DataAPIToken] = None
+    """The API token that changed."""
+
+    change: Optional[DataChange] = None
+    """
+    The transition an update event describes: `from` is the value before and `to`
+    the value after. Present only on update events (`*.updated`, `*.renamed`,
+    `*_changed`, `api_token.expiry_scheduled`, `environment.line_moved`,
+    `webhook_subscription.routing_headers_*`); created, deleted, enabled, disabled,
+    expired and activated events never carry it. `null` means none: `to: null` means
+    cleared and `from: null` means first set. The value type depends on the event
+    and is given in each event's description. `contact_card.updated` uses `name`
+    instead of `from` and `to`.
+    """
+
+    contact_card: Optional[DataContactCard] = None
+    """The contact card that changed."""
+
+    environment: Optional[DataEnvironment] = None
+    """An environment.
+
+    Production is `{"id": null, "name": "Production", "type": "production"}`; every
+    other environment has an `id` and type `environment`.
+    """
+
+    lines_moved_to_production: Optional[int] = None
+    """Lines moved to Production when an environment was deleted."""
+
+    method: Optional[Literal["code", "sso", "google", "apple", "linkedin"]] = None
+    """How the team member signed in.
+
+    `code` is a one-time code sent by email or text. Only on
+    `team_member.signed_in`.
+    """
+
+    phone_number: Optional[str] = None
+    """The line the change is about, in E.164 format."""
+
+    team_member: Optional[DataTeamMember] = None
+    """The team member the event is about."""
+
+    tokens_revoked: Optional[int] = None
+    """API tokens revoked when an environment was deleted."""
+
+    webhook_subscription: Optional[DataWebhookSubscription] = None
+    """The webhook subscription that changed."""
+
+
+class APITokenActivatedWebhookEvent(BaseModel):
+    """Webhook payload for account events.
+
+    One event type per kind of account change. `event_id` is the same on every retry and on every subscription the event is delivered to; use it to deduplicate. `created_at` is when the webhook was created and `data.occurred_at` when the change happened. Events are not guaranteed to arrive in order. Delivery is best-effort: if a delivery still fails after retries, the change remains on your Activity page. Changes to webhook subscriptions are account events too, so a subscription to `webhook_subscription.*` events receives an event about the subscription that was just created or edited.
+    """
+
+    api_version: str
+    """API version for the webhook payload format"""
+
+    created_at: datetime
+    """When the event was created"""
+
+    data: Data
+    """A change on your account, the same change shown on your Activity page.
+
+    Every event carries `summary`, `occurred_at`, `actor` and `origin`. The object
+    fields (`api_token`, `webhook_subscription`, `environment`, `contact_card`,
+    `phone_number`, `team_member`) identify what changed; on update events `change`
+    describes the transition. Created and deleted events carry only the object that
+    was created or deleted. Fields are absent when they don't apply; `null` appears
+    only inside `change` and as Production's environment `id`.
+    """
+
+    event_id: str
+    """Unique identifier for this event (for deduplication)"""
+
+    event_type: Literal[
+        "zero_day_retention.updated",
+        "phone_number.forwarding_updated",
+        "environment.line_moved",
+        "contact_card.created",
+        "contact_card.updated",
+        "contact_card.deleted",
+        "api_token.created",
+        "api_token.renamed",
+        "api_token.expiry_scheduled",
+        "api_token.expired",
+        "api_token.activated",
+        "api_token.deleted",
+        "environment.created",
+        "environment.renamed",
+        "environment.deleted",
+        "webhook_subscription.created",
+        "webhook_subscription.deleted",
+        "webhook_subscription.target_url_changed",
+        "webhook_subscription.enabled",
+        "webhook_subscription.disabled",
+        "webhook_subscription.events.updated",
+        "webhook_subscription.phone_numbers.updated",
+        "webhook_subscription.routing_headers_set",
+        "webhook_subscription.routing_headers_cleared",
+        "team_member.added",
+        "team_member.signed_in",
+        "team_member.signed_out",
+        "message.sent",
+        "message.received",
+        "message.read",
+        "message.delivered",
+        "message.failed",
+        "message.edited",
+        "reaction.added",
+        "reaction.removed",
+        "poll.received",
+        "poll.failed",
+        "poll.sent",
+        "poll.delivered",
+        "poll.read",
+        "poll.updated",
+        "poll.vote.added",
+        "poll.vote.removed",
+        "poll.reaction.added",
+        "participant.added",
+        "participant.removed",
+        "chat.created",
+        "chat.group_name_updated",
+        "chat.group_icon_updated",
+        "chat.group_name_update_failed",
+        "chat.group_icon_update_failed",
+        "chat.background_updated",
+        "chat.background_update_failed",
+        "chat.typing_indicator.started",
+        "chat.typing_indicator.stopped",
+        "phone_number.status_updated",
+        "phone_number.assigned",
+        "phone_number.released",
+        "contact_card.received",
+        "call.initiated",
+        "call.ringing",
+        "call.answered",
+        "call.ended",
+        "call.failed",
+        "call.declined",
+        "call.no_answer",
+        "location.sharing.started",
+        "location.sharing.stopped",
+        "payment.succeeded",
+        "payment.canceled",
+        "payment.expired",
+        "payment.declined",
+        "payment.authorized",
+        "connection.created",
+        "connection.revoked",
+    ]
+
+    partner_id: str
+    """Partner identifier. Present on all webhooks for cross-referencing."""
+
+    trace_id: str
+    """Trace ID for debugging and correlation across systems."""
+
+    webhook_version: str
+    """
+    Date-based webhook payload version. Determined by the `?version=` query
+    parameter in your webhook subscription URL. If no version parameter is
+    specified, defaults based on subscription creation date.
+    """