linq-python 0.50.0__tar.gz → 0.51.1__tar.gz

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

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

{linq_python-0.50.0 → linq_python-0.51.1}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.51.1](https://github.com/linq-team/linq-python/compare/v0.51.0...v0.51.1) (2026-09-09)
+
+
+### Bug Fixes
+
+* add 503 rate limit error responses to contact card endpoints ([8569c35](https://github.com/linq-team/linq-python/commit/8569c356e9f149e9ef5d34d1a00e427e521a831c))
+
+## [0.51.0](https://github.com/linq-team/linq-python/compare/v0.50.0...v0.51.0) (2026-09-09)
+
+
+### Features
+
+* add stop location sharing endpoint for chats ([4519df7](https://github.com/linq-team/linq-python/commit/4519df7219e38b11a909ec803f6bdbc0fd733e70))
+
 ## [0.50.0](https://github.com/linq-team/linq-python/compare/v0.49.0...v0.50.0) (2026-09-09)
 
 

{linq_python-0.50.0 → linq_python-0.51.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.50.0
+Version: 0.51.1
 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.50.0 → linq_python-0.51.1}/api.md

@@ -80,13 +80,18 @@ Methods:
 Types:
 
 ```python
-from linq.types.chats import GetChatLocationResponse, LocationRequestResponse
+from linq.types.chats import (
+    GetChatLocationResponse,
+    LocationRequestResponse,
+    StopChatLocationSharingResponse,
+)
 ```
 
 Methods:
 
 - <code title="get /v3/chats/{chatId}/location">client.chats.location.<a href="./src/linq/resources/chats/location.py">retrieve</a>(chat_id) -> <a href="./src/linq/types/chats/get_chat_location_response.py">GetChatLocationResponse</a></code>
 - <code title="post /v3/chats/{chatId}/location/request">client.chats.location.<a href="./src/linq/resources/chats/location.py">request</a>(chat_id) -> <a href="./src/linq/types/chats/location_request_response.py">LocationRequestResponse</a></code>
+- <code title="delete /v3/chats/{chatId}/location">client.chats.location.<a href="./src/linq/resources/chats/location.py">stop</a>(chat_id, \*\*<a href="src/linq/types/chats/location_stop_params.py">params</a>) -> <a href="./src/linq/types/chats/stop_chat_location_sharing_response.py">StopChatLocationSharingResponse</a></code>
 
 ## Polls
 

{linq_python-0.50.0 → linq_python-0.51.1}/pyproject.toml

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

{linq_python-0.50.0 → linq_python-0.51.1}/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.50.0"  # x-release-please-version
+__version__ = "0.51.1"  # x-release-please-version

{linq_python-0.50.0 → linq_python-0.51.1}/src/linq/resources/chats/location.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import httpx
 
 from ..._types import Body, Query, Headers, NotGiven, not_given
-from ..._utils import path_template
+from ..._utils import path_template, maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
@@ -14,9 +14,11 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ...types.chats import location_stop_params
 from ..._base_client import make_request_options
 from ...types.chats.location_request_response import LocationRequestResponse
 from ...types.chats.get_chat_location_response import GetChatLocationResponse
+from ...types.chats.stop_chat_location_sharing_response import StopChatLocationSharingResponse
 
 __all__ = ["LocationResource", "AsyncLocationResource"]
 
@@ -187,6 +189,68 @@ class LocationResource(SyncAPIResource):
             cast_to=LocationRequestResponse,
         )
 
+    def stop(
+        self,
+        chat_id: str,
+        *,
+        handle: str,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> StopChatLocationSharingResponse:
+        """
+        End the location share a contact started with you, as though they had stopped it
+        themselves. Their device stops listing you as someone they share with, so they
+        can start a fresh share cleanly.
+
+        Use this to recover when a share has gone stale — coordinates that stop
+        advancing, or a share you believe has ended but is still reported as active.
+        Without it the only remedy is asking the contact to stop and re-share, which is
+        confusing for them because their phone still shows everything as working.
+
+        This is not reversible from the API. Sharing can only resume when the contact
+        starts a new share, so prompt them to re-share afterwards. Request a new one
+        with `POST /v3/chats/{chatId}/location/request`.
+
+        Apple keeps one location-sharing relationship per person rather than per chat,
+        so this ends that contact's share everywhere, not only in this chat.
+
+        `handle` names whose share to end, and is always required — a group chat can
+        have several people sharing, and this is not an operation to infer a target for.
+
+        **This returns `202`, not `200`.** The removal happens on the device that holds
+        the sharing relationship, so a success here means the request was accepted, not
+        that sharing has ended. Wait for the `location.sharing.stopped` webhook to
+        confirm it — that webhook is what tells you the contact's device has actually
+        let go.
+
+        Returns `404` if the contact is not currently sharing.
+
+        Args:
+          handle: Phone number (E.164 format) or email address of the contact whose share to end
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not chat_id:
+            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
+        return self._delete(
+            path_template("/v3/chats/{chat_id}/location", chat_id=chat_id),
+            body=maybe_transform({"handle": handle}, location_stop_params.LocationStopParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=StopChatLocationSharingResponse,
+        )
+
 
 class AsyncLocationResource(AsyncAPIResource):
     """
@@ -354,6 +418,68 @@ class AsyncLocationResource(AsyncAPIResource):
             cast_to=LocationRequestResponse,
         )
 
+    async def stop(
+        self,
+        chat_id: str,
+        *,
+        handle: str,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> StopChatLocationSharingResponse:
+        """
+        End the location share a contact started with you, as though they had stopped it
+        themselves. Their device stops listing you as someone they share with, so they
+        can start a fresh share cleanly.
+
+        Use this to recover when a share has gone stale — coordinates that stop
+        advancing, or a share you believe has ended but is still reported as active.
+        Without it the only remedy is asking the contact to stop and re-share, which is
+        confusing for them because their phone still shows everything as working.
+
+        This is not reversible from the API. Sharing can only resume when the contact
+        starts a new share, so prompt them to re-share afterwards. Request a new one
+        with `POST /v3/chats/{chatId}/location/request`.
+
+        Apple keeps one location-sharing relationship per person rather than per chat,
+        so this ends that contact's share everywhere, not only in this chat.
+
+        `handle` names whose share to end, and is always required — a group chat can
+        have several people sharing, and this is not an operation to infer a target for.
+
+        **This returns `202`, not `200`.** The removal happens on the device that holds
+        the sharing relationship, so a success here means the request was accepted, not
+        that sharing has ended. Wait for the `location.sharing.stopped` webhook to
+        confirm it — that webhook is what tells you the contact's device has actually
+        let go.
+
+        Returns `404` if the contact is not currently sharing.
+
+        Args:
+          handle: Phone number (E.164 format) or email address of the contact whose share to end
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not chat_id:
+            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
+        return await self._delete(
+            path_template("/v3/chats/{chat_id}/location", chat_id=chat_id),
+            body=await async_maybe_transform({"handle": handle}, location_stop_params.LocationStopParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=StopChatLocationSharingResponse,
+        )
+
 
 class LocationResourceWithRawResponse:
     def __init__(self, location: LocationResource) -> None:
@@ -365,6 +491,9 @@ class LocationResourceWithRawResponse:
         self.request = to_raw_response_wrapper(
             location.request,
         )
+        self.stop = to_raw_response_wrapper(
+            location.stop,
+        )
 
 
 class AsyncLocationResourceWithRawResponse:
@@ -377,6 +506,9 @@ class AsyncLocationResourceWithRawResponse:
         self.request = async_to_raw_response_wrapper(
             location.request,
         )
+        self.stop = async_to_raw_response_wrapper(
+            location.stop,
+        )
 
 
 class LocationResourceWithStreamingResponse:
@@ -389,6 +521,9 @@ class LocationResourceWithStreamingResponse:
         self.request = to_streamed_response_wrapper(
             location.request,
         )
+        self.stop = to_streamed_response_wrapper(
+            location.stop,
+        )
 
 
 class AsyncLocationResourceWithStreamingResponse:
@@ -401,3 +536,6 @@ class AsyncLocationResourceWithStreamingResponse:
         self.request = async_to_streamed_response_wrapper(
             location.request,
         )
+        self.stop = async_to_streamed_response_wrapper(
+            location.stop,
+        )

{linq_python-0.50.0 → linq_python-0.51.1}/src/linq/resources/contact_card.py

@@ -74,6 +74,10 @@ class ContactCardResource(SyncAPIResource):
         If setup does not complete, the response is `500` (`2022`) — call this endpoint
         again.
 
+        If the upstream write is rate-limited, the response is `503` (`4004`) instead.
+        Setup did not complete and the card is not active — wait before retrying,
+        because repeated attempts extend the rate limit.
+
         **Note:** once a card is active, this endpoint returns `409` (`2014`) so an
         existing card is never overwritten by accident. Use `PATCH /v3/contact_card` to
         change it.
@@ -177,6 +181,10 @@ class ContactCardResource(SyncAPIResource):
         If the update does not complete, the response is `500` (`2022`) — call this
         endpoint again.
 
+        If the upstream write is rate-limited, the response is `503` (`4004`) instead.
+        The update did not reach the line, so the card is left not active — wait before
+        retrying, because repeated attempts extend the rate limit.
+
         Args:
           phone_number: E.164 phone number of the contact card to update
 
@@ -269,6 +277,10 @@ class AsyncContactCardResource(AsyncAPIResource):
         If setup does not complete, the response is `500` (`2022`) — call this endpoint
         again.
 
+        If the upstream write is rate-limited, the response is `503` (`4004`) instead.
+        Setup did not complete and the card is not active — wait before retrying,
+        because repeated attempts extend the rate limit.
+
         **Note:** once a card is active, this endpoint returns `409` (`2014`) so an
         existing card is never overwritten by accident. Use `PATCH /v3/contact_card` to
         change it.
@@ -372,6 +384,10 @@ class AsyncContactCardResource(AsyncAPIResource):
         If the update does not complete, the response is `500` (`2022`) — call this
         endpoint again.
 
+        If the upstream write is rate-limited, the response is `503` (`4004`) instead.
+        The update did not reach the line, so the card is left not active — wait before
+        retrying, because repeated attempts extend the rate limit.
+
         Args:
           phone_number: E.164 phone number of the contact card to update
 

{linq_python-0.50.0 → linq_python-0.51.1}/src/linq/types/chats/__init__.py

@@ -8,6 +8,7 @@ from .poll_envelope import PollEnvelope as PollEnvelope
 from .poll_create_params import PollCreateParams as PollCreateParams
 from .message_list_params import MessageListParams as MessageListParams
 from .message_send_params import MessageSendParams as MessageSendParams
+from .location_stop_params import LocationStopParams as LocationStopParams
 from .background_set_params import BackgroundSetParams as BackgroundSetParams
 from .message_send_response import MessageSendResponse as MessageSendResponse
 from .participant_add_params import ParticipantAddParams as ParticipantAddParams
@@ -16,3 +17,4 @@ from .location_request_response import LocationRequestResponse as LocationReques
 from .participant_remove_params import ParticipantRemoveParams as ParticipantRemoveParams
 from .get_chat_location_response import GetChatLocationResponse as GetChatLocationResponse
 from .participant_remove_response import ParticipantRemoveResponse as ParticipantRemoveResponse
+from .stop_chat_location_sharing_response import StopChatLocationSharingResponse as StopChatLocationSharingResponse

linq_python-0.51.1/src/linq/types/chats/location_stop_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["LocationStopParams"]
+
+
+class LocationStopParams(TypedDict, total=False):
+    handle: Required[str]
+    """Phone number (E.164 format) or email address of the contact whose share to end"""

linq_python-0.51.1/src/linq/types/chats/stop_chat_location_sharing_response.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["StopChatLocationSharingResponse"]
+
+
+class StopChatLocationSharingResponse(BaseModel):
+    message: str
+
+    success: bool

{linq_python-0.50.0 → linq_python-0.51.1}/tests/api_resources/chats/test_location.py

@@ -9,7 +9,11 @@ import pytest
 
 from linq import LinqAPIV3, AsyncLinqAPIV3
 from tests.utils import assert_matches_type
-from linq.types.chats import GetChatLocationResponse, LocationRequestResponse
+from linq.types.chats import (
+    GetChatLocationResponse,
+    LocationRequestResponse,
+    StopChatLocationSharingResponse,
+)
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
@@ -101,6 +105,52 @@ class TestLocation:
                 "",
             )
 
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_method_stop(self, client: LinqAPIV3) -> None:
+        location = client.chats.location.stop(
+            chat_id="975d0776-bd17-4273-8337-f346b4c661b0",
+            handle="+15551234567",
+        )
+        assert_matches_type(StopChatLocationSharingResponse, location, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_raw_response_stop(self, client: LinqAPIV3) -> None:
+        response = client.chats.location.with_raw_response.stop(
+            chat_id="975d0776-bd17-4273-8337-f346b4c661b0",
+            handle="+15551234567",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        location = response.parse()
+        assert_matches_type(StopChatLocationSharingResponse, location, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_streaming_response_stop(self, client: LinqAPIV3) -> None:
+        with client.chats.location.with_streaming_response.stop(
+            chat_id="975d0776-bd17-4273-8337-f346b4c661b0",
+            handle="+15551234567",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            location = response.parse()
+            assert_matches_type(StopChatLocationSharingResponse, location, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    def test_path_params_stop(self, client: LinqAPIV3) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `chat_id` but received ''"):
+            client.chats.location.with_raw_response.stop(
+                chat_id="",
+                handle="+15551234567",
+            )
+
 
 class TestAsyncLocation:
     parametrize = pytest.mark.parametrize(
@@ -190,3 +240,49 @@ class TestAsyncLocation:
             await async_client.chats.location.with_raw_response.request(
                 "",
             )
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_method_stop(self, async_client: AsyncLinqAPIV3) -> None:
+        location = await async_client.chats.location.stop(
+            chat_id="975d0776-bd17-4273-8337-f346b4c661b0",
+            handle="+15551234567",
+        )
+        assert_matches_type(StopChatLocationSharingResponse, location, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_raw_response_stop(self, async_client: AsyncLinqAPIV3) -> None:
+        response = await async_client.chats.location.with_raw_response.stop(
+            chat_id="975d0776-bd17-4273-8337-f346b4c661b0",
+            handle="+15551234567",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        location = await response.parse()
+        assert_matches_type(StopChatLocationSharingResponse, location, path=["response"])
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_streaming_response_stop(self, async_client: AsyncLinqAPIV3) -> None:
+        async with async_client.chats.location.with_streaming_response.stop(
+            chat_id="975d0776-bd17-4273-8337-f346b4c661b0",
+            handle="+15551234567",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            location = await response.parse()
+            assert_matches_type(StopChatLocationSharingResponse, location, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Mock server tests are disabled")
+    @parametrize
+    async def test_path_params_stop(self, async_client: AsyncLinqAPIV3) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `chat_id` but received ''"):
+            await async_client.chats.location.with_raw_response.stop(
+                chat_id="",
+                handle="+15551234567",
+            )

{linq_python-0.50.0 → linq_python-0.51.1}/uv.lock

@@ -530,7 +530,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.49.0"
+version = "0.51.0"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

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

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