Create saved search name

Author: KirillSergeevich

linkedapi/errors.py

@@ -31,7 +31,10 @@
     "listNotDeletable",
     "listNotRenamable",
     "savedSearchNotFound",
-    "interfaceLanguageNotSupported",
+    "savedSearchAlreadyExists",
+    "savedSearchLimitReached",
+    "savedSearchRenameUnconfirmed",
+    "savedSearchQueryMismatch",
     "postNotFound",
     "jobNotFound",
     "commentingNotAllowed",
@@ -86,7 +89,10 @@
     "listNotDeletable",
     "listNotRenamable",
     "savedSearchNotFound",
-    "interfaceLanguageNotSupported",
+    "savedSearchAlreadyExists",
+    "savedSearchLimitReached",
+    "savedSearchRenameUnconfirmed",
+    "savedSearchQueryMismatch",
     "postNotFound",
     "jobNotFound",
     "commentingNotAllowed",

linkedapi/operations/nv_create_saved_search.py

@@ -6,8 +6,9 @@
 
 
 class NvCreateSavedSearch(Operation[NvCreateSavedSearchParams, NvCreatedSavedSearch]):
-    """Save a Sales Navigator search URL matching the requested type. Returns its id, name,
-    type and URL. English interface only.
+    """Save a Sales Navigator search URL matching the requested type. Optional name: trimmed,
+    single line, 1-256 characters, unique per type (savedSearchAlreadyExists). Returns its id,
+    name, type and URL.
     """
 
     operation_name = "nvCreateSavedSearch"

linkedapi/operations/nv_delete_saved_search.py

@@ -7,7 +7,7 @@
 
 class NvDeleteSavedSearch(Operation[NvDeleteSavedSearchParams, None]):
     """Delete an owned saved search by its string ID. An absent search returns
-    savedSearchNotFound. English interface only.
+    savedSearchNotFound.
     """
 
     operation_name = "nvDeleteSavedSearch"

linkedapi/operations/nv_remove_account_from_list.py

@@ -7,7 +7,7 @@
 
 class NvRemoveAccountFromList(Operation[NvRemoveAccountFromListParams, None]):
     """Remove an account from exactly one owned custom list, keeping it saved even after its
-    last list. Repeating an absent membership succeeds. English interface only.
+    last list. Repeating an absent membership succeeds.
     """
 
     operation_name = "nvRemoveAccountFromList"

linkedapi/operations/nv_remove_lead_from_list.py

@@ -7,7 +7,7 @@
 
 class NvRemoveLeadFromList(Operation[NvRemoveLeadFromListParams, None]):
     """Remove a lead from exactly one owned custom list, keeping it saved and in its other
-    lists. Repeating an absent membership succeeds. English interface only.
+    lists. Repeating an absent membership succeeds.
     """
 
     operation_name = "nvRemoveLeadFromList"

linkedapi/operations/nv_rename_list.py

@@ -8,7 +8,6 @@
 class NvRenameList(Operation[NvRenameListParams, NvCreatedList]):
     """Rename an owned custom list. Trimmed name: 1-75 characters, no line breaks. Same name
     succeeds; duplicates return listAlreadyExists and system lists return listNotRenamable.
-    English interface only.
     """
 
     operation_name = "nvRenameList"

linkedapi/types/nv_saved_searches.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
-from typing import Literal
+from typing import Annotated, Literal
 
-from pydantic import Field
+from pydantic import Field, StringConstraints
 
 from linkedapi.types.base import LinkedApiModel
 from linkedapi.types.params import BaseActionParams
@@ -15,6 +15,18 @@ class NvRetrieveSavedSearchesParams(BaseActionParams):
 class NvCreateSavedSearchParams(BaseActionParams):
     type: Literal["lead", "account"]
     custom_search_url: str = Field(min_length=1)
+    name: (
+        Annotated[
+            str,
+            StringConstraints(
+                strip_whitespace=True,
+                min_length=1,
+                max_length=256,
+                pattern=r"^[^\r\n\u2028\u2029]+$",
+            ),
+        ]
+        | None
+    ) = None
 
 
 class NvDeleteSavedSearchParams(BaseActionParams):

tests/test_errors.py

@@ -62,7 +62,10 @@ def test_error_type_sets_match_node_contract() -> None:
         "listNotDeletable",
         "listNotRenamable",
         "savedSearchNotFound",
-        "interfaceLanguageNotSupported",
+        "savedSearchAlreadyExists",
+        "savedSearchLimitReached",
+        "savedSearchRenameUnconfirmed",
+        "savedSearchQueryMismatch",
         "postNotFound",
         "jobNotFound",
         "commentingNotAllowed",

tests/test_nv_backlog.py

@@ -79,6 +79,14 @@ def client() -> LinkedApi:
             NvCreateSavedSearchParams(type="lead", custom_search_url=SEARCH_URL),
             {"type": "lead", "customSearchUrl": SEARCH_URL},
         ),
+        (
+            "nv_create_saved_search",
+            "nv.createSavedSearch",
+            NvCreateSavedSearchParams(
+                type="lead", custom_search_url=SEARCH_URL, name="  Heads of Sales  "
+            ),
+            {"type": "lead", "customSearchUrl": SEARCH_URL, "name": "Heads of Sales"},
+        ),
         (
             "nv_delete_saved_search",
             "nv.deleteSavedSearch",
@@ -220,3 +228,9 @@ def test_public_action_errors(operation: str, action: str, error_type: str) -> N
     )
     assert result.data is None
     assert [item.model_dump() for item in result.errors] == [error]
+
+
+@pytest.mark.parametrize("name", ["", "   ", "a" * 257, "Heads\nof Sales"])
+def test_create_saved_search_rejects_invalid_names(name: str) -> None:
+    with pytest.raises(ValidationError):
+        NvCreateSavedSearchParams(type="lead", custom_search_url=SEARCH_URL, name=name)

tests/test_nv_list_management.py

@@ -87,7 +87,6 @@ def test_delete_exact_string_id_and_void_result(requests_mock: requests_mock.Moc
         ("nv_create_list", "nv.createList", error)
         for error in [
             "listAlreadyExists",
-            "interfaceLanguageNotSupported",
             "noSalesNavigator",
             "unexpectedError",
         ]
@@ -97,7 +96,6 @@ def test_delete_exact_string_id_and_void_result(requests_mock: requests_mock.Moc
         for error in [
             "listNotFound",
             "listNotDeletable",
-            "interfaceLanguageNotSupported",
             "noSalesNavigator",
             "unexpectedError",
         ]