UncountablePythonSDK 0.0.29__tar.gz → 0.0.31__tar.gz

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/.github/workflows/documentation.yml

@@ -9,9 +9,9 @@ jobs:
   docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v3
-      - uses: extractions/setup-just@v1
+      - uses: actions/checkout@f43a0e5ff2bd294095638e18286ca9a3d1956744 # v3
+      - uses: actions/setup-python@82c7e631bb3cdc910f68e0081d67478d79c6982d # v5
+      - uses: extractions/setup-just@dd310ad5a97d8e7b41793f8ef055398d51ad4de6 # v2
         with:
             just-version: '1.8.0'
             github-token: ${{ secrets.GITHUB_TOKEN }}
@@ -25,7 +25,7 @@ jobs:
         run: |
           just -f docs/justfile docs-build
       - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@4f9cc6602d3f66b9c108549d475ec49e8ef4d45e # v4
         if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
         with:
           publish_branch: gh-pages

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/.github/workflows/publish.yml

@@ -19,10 +19,10 @@ jobs:
     name: Build distribution packages
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4
         with:
           fetch-depth: 0
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@82c7e631bb3cdc910f68e0081d67478d79c6982d # v5
         with:
           python-version: '3.11'
       - name: Install build dependencies
@@ -31,7 +31,7 @@ jobs:
       - name: Build distributions and wheels
         run: |
           python3 -m build
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@65462800fd760344b1a7b4382951275a0abb4808 # v4
         with:
           name: package-distributions
           path: dist/
@@ -45,9 +45,9 @@ jobs:
     permissions:
       id-token: write
     steps:
-    - uses: actions/download-artifact@v4
+    - uses: actions/download-artifact@65a9edc5881444af0b9093a5e628f2fe47ea3b2e # v4
       with:
         name: package-distributions
         path: dist/
     - name: Publish package distributions to PyPI
-      uses: pypa/gh-action-pypi-publish@e53eb8b103ffcb59469888563dc324e3c8ba6f06
+      uses: pypa/gh-action-pypi-publish@ec4db0b4ddc65acdf4bff5fa45ac92d78b56bdf0

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/.gitignore

@@ -22,3 +22,8 @@ tox.ini
 .ipynb_checkpoints
 *.ipynb
 
+# OVERRIDES FROM MAIN
+!*.txt
+!*.gif
+!*.jpg
+!*.png

{uncountablepythonsdk-0.0.29/UncountablePythonSDK.egg-info → uncountablepythonsdk-0.0.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.29
+Version: 0.0.31
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -27,9 +27,9 @@ Requires-Dist: PyYAML==6.*
 Provides-Extra: test
 Requires-Dist: mypy==1.*; extra == "test"
 Requires-Dist: ruff==0.*; extra == "test"
-Requires-Dist: pytest==7.*; extra == "test"
-Requires-Dist: coverage[toml]==6.*; extra == "test"
-Requires-Dist: pytest-cov==4.*; extra == "test"
+Requires-Dist: pytest==8.*; extra == "test"
+Requires-Dist: coverage[toml]==7.*; extra == "test"
+Requires-Dist: pytest-cov==5.*; extra == "test"
 Requires-Dist: pytest-xdist==3.*; extra == "test"
 
 # Uncountable Python SDK

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31/UncountablePythonSDK.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.29
+Version: 0.0.31
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -27,9 +27,9 @@ Requires-Dist: PyYAML==6.*
 Provides-Extra: test
 Requires-Dist: mypy==1.*; extra == "test"
 Requires-Dist: ruff==0.*; extra == "test"
-Requires-Dist: pytest==7.*; extra == "test"
-Requires-Dist: coverage[toml]==6.*; extra == "test"
-Requires-Dist: pytest-cov==4.*; extra == "test"
+Requires-Dist: pytest==8.*; extra == "test"
+Requires-Dist: coverage[toml]==7.*; extra == "test"
+Requires-Dist: pytest-cov==5.*; extra == "test"
 Requires-Dist: pytest-xdist==3.*; extra == "test"
 
 # Uncountable Python SDK

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/UncountablePythonSDK.egg-info/SOURCES.txt

@@ -27,7 +27,6 @@ docs/static/favicons/safari-pinned-tab.svg
 examples/async_batch.py
 examples/create_entity.py
 examples/upload_files.py
-examples/recipe-import/importer.py
 pkgs/__init__.py
 pkgs/argument_parser/__init__.py
 pkgs/argument_parser/_is_enum.py
@@ -69,57 +68,6 @@ pkgs/type_spec/value_spec/__main__.py
 pkgs/type_spec/value_spec/convert_type.py
 pkgs/type_spec/value_spec/emit_python.py
 pkgs/type_spec/value_spec/types.py
-type_spec/external/api/batch/execute_batch.yaml
-type_spec/external/api/batch/execute_batch_load_async.yaml
-type_spec/external/api/chemical/convert_chemical_formats.yaml
-type_spec/external/api/entity/create_entities.yaml
-type_spec/external/api/entity/create_entity.yaml
-type_spec/external/api/entity/get_entities_data.yaml
-type_spec/external/api/entity/list_entities.yaml
-type_spec/external/api/entity/lock_entity.yaml
-type_spec/external/api/entity/resolve_entity_ids.yaml
-type_spec/external/api/entity/set_values.yaml
-type_spec/external/api/entity/transition_entity_phase.yaml
-type_spec/external/api/entity/unlock_entity.yaml
-type_spec/external/api/field_options/upsert_field_options.yaml
-type_spec/external/api/id_source/list_id_source.yaml
-type_spec/external/api/id_source/match_id_source.yaml
-type_spec/external/api/input_groups/get_input_group_names.yaml
-type_spec/external/api/inputs/create_inputs.yaml
-type_spec/external/api/inputs/get_input_data.yaml
-type_spec/external/api/inputs/get_input_names.yaml
-type_spec/external/api/inputs/get_inputs_data.yaml
-type_spec/external/api/inputs/set_input_attribute_values.yaml
-type_spec/external/api/inputs/set_input_category.yaml
-type_spec/external/api/inputs/set_input_subcategories.yaml
-type_spec/external/api/material_families/update_entity_material_families.yaml
-type_spec/external/api/outputs/get_output_data.yaml
-type_spec/external/api/outputs/get_output_names.yaml
-type_spec/external/api/outputs/resolve_output_conditions.yaml
-type_spec/external/api/permissions/set_core_permissions.yaml
-type_spec/external/api/project/get_projects.yaml
-type_spec/external/api/project/get_projects_data.yaml
-type_spec/external/api/recipe_links/create_recipe_link.yaml
-type_spec/external/api/recipe_metadata/get_recipe_metadata_data.yaml
-type_spec/external/api/recipes/archive_recipes.yaml
-type_spec/external/api/recipes/associate_recipe_as_input.yaml
-type_spec/external/api/recipes/associate_recipe_as_lot.yaml
-type_spec/external/api/recipes/create_recipe.yaml
-type_spec/external/api/recipes/create_recipes.yaml
-type_spec/external/api/recipes/disassociate_recipe_as_input.yaml
-type_spec/external/api/recipes/edit_recipe_inputs.yaml
-type_spec/external/api/recipes/get_curve.yaml
-type_spec/external/api/recipes/get_recipe_calculations.yaml
-type_spec/external/api/recipes/get_recipe_links.yaml
-type_spec/external/api/recipes/get_recipe_names.yaml
-type_spec/external/api/recipes/get_recipe_output_metadata.yaml
-type_spec/external/api/recipes/get_recipes_data.yaml
-type_spec/external/api/recipes/set_recipe_inputs.yaml
-type_spec/external/api/recipes/set_recipe_metadata.yaml
-type_spec/external/api/recipes/set_recipe_outputs.yaml
-type_spec/external/api/recipes/set_recipe_tags.yaml
-type_spec/external/api/recipes/unarchive_recipes.yaml
-type_spec/external/api/triggers/run_trigger.yaml
 uncountable/__init__.py
 uncountable/py.typed
 uncountable/core/__init__.py
@@ -165,6 +113,7 @@ uncountable/types/recipe_metadata.py
 uncountable/types/recipe_output_metadata.py
 uncountable/types/recipe_tags.py
 uncountable/types/recipe_workflow_steps.py
+uncountable/types/recipes.py
 uncountable/types/response.py
 uncountable/types/units.py
 uncountable/types/users.py
@@ -200,6 +149,7 @@ uncountable/types/api/inputs/get_inputs_data.py
 uncountable/types/api/inputs/set_input_attribute_values.py
 uncountable/types/api/inputs/set_input_category.py
 uncountable/types/api/inputs/set_input_subcategories.py
+uncountable/types/api/inputs/set_intermediate_type.py
 uncountable/types/api/material_families/__init__.py
 uncountable/types/api/material_families/update_entity_material_families.py
 uncountable/types/api/outputs/__init__.py
@@ -216,6 +166,7 @@ uncountable/types/api/recipe_links/create_recipe_link.py
 uncountable/types/api/recipe_metadata/__init__.py
 uncountable/types/api/recipe_metadata/get_recipe_metadata_data.py
 uncountable/types/api/recipes/__init__.py
+uncountable/types/api/recipes/add_recipe_to_project.py
 uncountable/types/api/recipes/archive_recipes.py
 uncountable/types/api/recipes/associate_recipe_as_input.py
 uncountable/types/api/recipes/associate_recipe_as_lot.py
@@ -229,6 +180,7 @@ uncountable/types/api/recipes/get_recipe_links.py
 uncountable/types/api/recipes/get_recipe_names.py
 uncountable/types/api/recipes/get_recipe_output_metadata.py
 uncountable/types/api/recipes/get_recipes_data.py
+uncountable/types/api/recipes/remove_recipe_from_project.py
 uncountable/types/api/recipes/set_recipe_inputs.py
 uncountable/types/api/recipes/set_recipe_metadata.py
 uncountable/types/api/recipes/set_recipe_outputs.py

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/UncountablePythonSDK.egg-info/requires.txt

@@ -10,7 +10,7 @@ PyYAML==6.*
 [test]
 mypy==1.*
 ruff==0.*
-pytest==7.*
-coverage[toml]==6.*
-pytest-cov==4.*
+pytest==8.*
+coverage[toml]==7.*
+pytest-cov==5.*
 pytest-xdist==3.*

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/UncountablePythonSDK.egg-info/top_level.txt

@@ -2,5 +2,4 @@ dist
 docs
 examples
 pkgs
-type_spec
 uncountable

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/docs/conf.py

@@ -7,7 +7,6 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 from datetime import date
-import uncountable
 
 project = "Uncountable SDK"
 copyright = f"{date.today().year}, Uncountable Inc"
@@ -26,9 +25,15 @@ extensions = [
 myst_enable_extensions = ["fieldlist", "deflist"]
 
 autoapi_dirs = ["../uncountable"]
-autoapi_options = [ 'members', 'undoc-members', 'show-inheritance', 'show-module-summary', 'imported-members' ]
-autoapi_ignore = ['*integration*']
-autodoc_typehints = 'description'
+autoapi_options = [
+    "members",
+    "undoc-members",
+    "show-inheritance",
+    "show-module-summary",
+    "imported-members",
+]
+autoapi_ignore = ["*integration*"]
+autodoc_typehints = "description"
 
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 

uncountablepythonsdk-0.0.31/docs/requirements.txt

@@ -0,0 +1,7 @@
+furo==2024.5.6
+myst-parser==3.0.1
+sphinx-autoapi==3.1.0
+sphinx-copybutton==0.5.2
+Sphinx==7.3.7
+sphinx_design==0.6.0
+sphinx-favicon==1.0.1

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/examples/async_batch.py

@@ -1,6 +1,6 @@
 from decimal import Decimal
-from uncountable.core import AuthDetailsApiKey, Client
-from uncountable.core import AsyncBatchProcessor
+
+from uncountable.core import AsyncBatchProcessor, AuthDetailsApiKey, Client
 from uncountable.types import (
     recipe_metadata,
 )
@@ -10,7 +10,6 @@ from uncountable.types.recipe_identifiers import (
     RecipeIdentifiers,
 )
 
-
 client = Client(
     base_url="https://app.uncountable.com",
     auth_details=AuthDetailsApiKey(

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/examples/create_entity.py

@@ -1,23 +1,20 @@
 from uncountable.core import AuthDetailsOAuth, Client
+from uncountable.core.client import ClientConfig
 from uncountable.types import (
     entity_t,
     field_values_t,
 )
 
-
 client = Client(
     base_url="https://app.uncountable.com",
-    auth_details=AuthDetailsOAuth(
-        refresh_token="x"
-    ),
+    auth_details=AuthDetailsOAuth(refresh_token="x"),
+    config=ClientConfig(allow_insecure_tls=False),
 )
 entities = client.create_entity(
     definition_id=24,
     entity_type=entity_t.EntityType.LAB_REQUEST,
     field_values=[
-        field_values_t.FieldRefNameValue(
-            field_ref_name="name", value="SDK Lab Request"
-        ),
+        field_values_t.FieldRefNameValue(field_ref_name="name", value="SDK Lab Request"),
         field_values_t.FieldRefNameValue(field_ref_name="materialFamilyId", value=1),
     ],
 )

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/examples/upload_files.py

@@ -1,7 +1,7 @@
 import os
 from pprint import pprint
 
-from uncountable import AuthDetailsApiKey, Client, MediaFileUpload
+from uncountable.core import AuthDetailsApiKey, Client, MediaFileUpload
 
 client = Client(
     base_url="http://localhost:5000",

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/pkgs/argument_parser/case_convert.py

@@ -4,9 +4,10 @@ import re
 
 @functools.lru_cache(maxsize=500000)
 def snake_to_camel_case(o: str) -> str:
-    return "".join([
-        part.title() if i > 0 else part for i, part in enumerate(o.split("_"))
-    ])
+    tokens = o.split("_")
+    if len(tokens) < 2:
+        return o
+    return "".join([part.title() if i > 0 else part for i, part in enumerate(tokens)])
 
 
 def kebab_to_pascal_case(o: str) -> str:

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/pkgs/serialization/serial_class.py

@@ -16,6 +16,9 @@ class _SerialClassData:
     parse_require: set[str] = dataclasses.field(default_factory=set)
 
 
+EMPTY_SERIAL_CLASS_DATA = _SerialClassData()
+
+
 def serial_class(
     *,
     unconverted_keys: Optional[set[str]] = None,
@@ -57,58 +60,49 @@ def serial_class(
 
 
 class SerialClassDataInspector:
-    bases: list[SerialClassDataInspector]
-
     def __init__(
-        self, bases: list[SerialClassDataInspector], current: _SerialClassData
+        self,
+        current: _SerialClassData,
     ) -> None:
-        self.bases = bases
         self.current = current
 
     def has_unconverted_key(self, key: str) -> bool:
-        if key in self.current.unconverted_keys:
-            return True
-        for base in self.bases:
-            if base.has_unconverted_key(key):
-                return True
-        return False
+        return key in self.current.unconverted_keys
 
     def has_unconverted_value(self, key: str) -> bool:
-        if key in self.current.unconverted_values:
-            return True
-        for base in self.bases:
-            if base.has_unconverted_value(key):
-                return True
-        return False
+        return key in self.current.unconverted_values
 
     def has_to_string_value(self, key: str) -> bool:
-        if key in self.current.to_string_values:
-            return True
-        for base in self.bases:
-            if base.has_to_string_value(key):
-                return True
-        return False
+        return key in self.current.to_string_values
 
     def has_parse_require(self, key: str) -> bool:
-        if key in self.current.parse_require:
-            return True
-        for base in self.bases:
-            if base.has_parse_require(key):
-                return True
-        return False
+        return key in self.current.parse_require
 
 
-def get_serial_class_data(type_class: type[Any]) -> SerialClassDataInspector:
-    bases = (
-        [get_serial_class_data(base) for base in type_class.__bases__]
-        if type_class.__bases__ is not None
-        else []
-    )
-    return SerialClassDataInspector(
-        bases,
+def _get_merged_serial_class_data(type_class: type[Any]) -> _SerialClassData | None:
+    base_class_data = (
         cast(_SerialClassData, type_class.__unc_serial_data)
         if hasattr(type_class, "__unc_serial_data")
-        else _SerialClassData(),
+        else None
+    )
+    if type_class.__bases__ is not None:
+        for base in type_class.__bases__:
+            curr_base_class_data = _get_merged_serial_class_data(base)
+            if curr_base_class_data is not None:
+                if base_class_data is None:
+                    base_class_data = _SerialClassData()
+                base_class_data.unconverted_keys |= curr_base_class_data.unconverted_keys
+                base_class_data.unconverted_values |= (
+                    curr_base_class_data.unconverted_values
+                )
+                base_class_data.to_string_values |= curr_base_class_data.to_string_values
+                base_class_data.parse_require |= curr_base_class_data.parse_require
+    return base_class_data
+
+
+def get_serial_class_data(type_class: type[Any]) -> SerialClassDataInspector:
+    return SerialClassDataInspector(
+        _get_merged_serial_class_data(type_class) or EMPTY_SERIAL_CLASS_DATA
     )
 
 

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/pkgs/type_spec/emit_python.py

@@ -1194,7 +1194,6 @@ ASYNC_BATCH_PROCESSOR_FILENAME = "async_batch_processor"
 ASYNC_BATCH_PROCESSOR_IMPORTS = [
     "import uuid",
     "from abc import ABC, abstractmethod",
-    "from dataclasses import dataclass",
     "from pkgs.serialization_util.serialization_helpers import serialize_for_api",
 ]
 

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/pkgs/type_spec/type_info/emit_type_info.py

@@ -247,17 +247,25 @@ def _extract_and_validate_layout(
     return layout
 
 
-def _validate_type_ext_info(stype: builder.SpecTypeDefnObject) -> ExtInfoLayout | None:
+def _validate_type_ext_info(
+    stype: builder.SpecTypeDefnObject,
+) -> tuple[ExtInfoLayout | None, Optional[data_t.ExtInfo]]:
     ext_info = _parse_ext_info(stype.ext_info)
     if ext_info is None:
-        return None
+        return None, None
+
+    if ext_info.label_fields is not None:
+        assert stype.properties is not None
+        for name in ext_info.label_fields:
+            prop = stype.properties.get(name)
+            assert prop is not None, f"missing-label-field:{name}"
 
     if not stype.is_base and isinstance(stype.base, builder.SpecTypeDefnObject):
-        base_layout = _validate_type_ext_info(stype.base)
+        base_layout, _ = _validate_type_ext_info(stype.base)
     else:
         base_layout = None
 
-    return _extract_and_validate_layout(stype, ext_info, base_layout)
+    return _extract_and_validate_layout(stype, ext_info, base_layout), ext_info
 
 
 def _build_map_type(
@@ -270,7 +278,7 @@ def _build_map_type(
         and not stype.is_base
         and stype.base is not None
     ):
-        _validate_type_ext_info(stype)
+        _, ext_info = _validate_type_ext_info(stype)
 
         properties: dict[str, MapProperty] = {}
         map_type = MapTypeObject(
@@ -279,7 +287,7 @@ def _build_map_type(
             properties=properties,
             desc=stype.desc,
             base_type_path=type_path_of(stype.base),
-            ext_info=_convert_ext_info(stype.ext_info),
+            ext_info=serialize_for_api(ext_info),
         )
 
         if stype.properties is not None:

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/pyproject.toml

@@ -67,9 +67,9 @@ test = [
     "mypy == 1.*",
     "ruff == 0.*",
     # Testing
-    "pytest == 7.*",
-    "coverage[toml] == 6.*",
-    "pytest-cov == 4.*",
+    "pytest ==8.*",
+    "coverage[toml] ==7.*",
+    "pytest-cov ==5.*",
     "pytest-xdist == 3.*",
 ]
 

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/uncountable/__init__.py

@@ -1,5 +1,4 @@
-from . import types
-from . import core
+from . import core, types
 
 __all__ = []
 __all__ += types.__all__

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/uncountable/core/__init__.py

@@ -1,6 +1,13 @@
+from .async_batch import AsyncBatchProcessor
 from .client import Client
-from .types import AuthDetailsApiKey, AuthDetailsOAuth
 from .file_upload import MediaFileUpload, UploadedFile
-from .async_batch import AsyncBatchProcessor
+from .types import AuthDetailsApiKey, AuthDetailsOAuth
 
-__all__: list[str] = ["AuthDetailsApiKey", "AuthDetailsOAuth", "AsyncBatchProcessor", "Client", "MediaFileUpload", "UploadedFile"]
+__all__: list[str] = [
+    "AuthDetailsApiKey",
+    "AuthDetailsOAuth",
+    "AsyncBatchProcessor",
+    "Client",
+    "MediaFileUpload",
+    "UploadedFile",
+]

{uncountablepythonsdk-0.0.29 → uncountablepythonsdk-0.0.31}/uncountable/core/client.py

@@ -1,10 +1,11 @@
 import base64
-from datetime import datetime, timedelta
 import json
 import typing
 from dataclasses import dataclass
+from datetime import datetime, timedelta
 from enum import StrEnum
 from urllib.parse import urljoin
+from uuid import uuid4
 
 import requests
 from requests.exceptions import JSONDecodeError
@@ -18,6 +19,7 @@ from .file_upload import FileUpload, FileUploader, UploadedFile
 from .types import AuthDetailsAll, AuthDetailsApiKey, AuthDetailsOAuth
 
 DT = typing.TypeVar("DT")
+UNC_REQUEST_ID_HEADER = "X-UNC-REQUEST-ID"
 
 
 class EndpointMethod(StrEnum):
@@ -30,19 +32,17 @@ class HTTPRequestBase:
     method: EndpointMethod
     url: str
     headers: dict[str, str]
-    body: typing.Optional[typing.Union[str, dict[str, str]]] = None
-    query_params: typing.Optional[dict[str, str]] = None
 
 
 @dataclass(kw_only=True)
 class HTTPGetRequest(HTTPRequestBase):
-    method: typing.Literal[EndpointMethod.GET]
+    method = EndpointMethod.GET
     query_params: dict[str, str]
 
 
 @dataclass(kw_only=True)
 class HTTPPostRequest(HTTPRequestBase):
-    method: typing.Literal[EndpointMethod.POST]
+    method = EndpointMethod.POST
     body: typing.Union[str, dict[str, str]]
 
 
@@ -101,13 +101,15 @@ class APIResponseError(BaseException):
 
 class SDKError(BaseException):
     message: str
+    request_id: str
 
-    def __init__(self, message: str) -> None:
+    def __init__(self, message: str, *, request_id: str) -> None:
         super().__init__(message)
         self.message = message
+        self.request_id = request_id
 
     def __str__(self) -> str:
-        return f"internal SDK error, please contact Uncountable support: {self.message}"
+        return f"internal SDK error (request id {self.request_id}), please contact Uncountable support: {self.message}"
 
 
 @dataclass(kw_only=True)
@@ -147,7 +149,9 @@ class Client(ClientMethods):
         self._file_uploader = FileUploader(self._base_url, self._auth_details)
         self._cfg = config or ClientConfig()
 
-    def _get_response_json(self, response: requests.Response) -> dict[str, JsonValue]:
+    def _get_response_json(
+        self, response: requests.Response, request_id: str
+    ) -> dict[str, JsonValue]:
         if response.status_code < 200 or response.status_code > 299:
             extra_details: dict[str, JsonValue] | None = None
             try:
@@ -160,12 +164,15 @@ class Client(ClientMethods):
                 status_code=response.status_code, extra_details=extra_details
             )
         try:
-            return response.json()
-        except JSONDecodeError:
-            raise SDKError("unable to process response")
+            return typing.cast(dict[str, JsonValue], response.json())
+        except JSONDecodeError as e:
+            raise SDKError("unable to process response", request_id=request_id) from e
 
     def do_request(self, *, api_request: APIRequest, return_type: type[DT]) -> DT:
-        http_request = self._build_http_request(api_request=api_request)
+        request_id = str(uuid4())
+        http_request = self._build_http_request(
+            api_request=api_request, request_id=request_id
+        )
         match http_request:
             case HTTPGetRequest():
                 response = requests.get(
@@ -179,18 +186,17 @@ class Client(ClientMethods):
                     http_request.url,
                     headers=http_request.headers,
                     data=http_request.body,
-                    params=http_request.query_params,
                     verify=not self._cfg.allow_insecure_tls,
                 )
             case _:
                 typing.assert_never(http_request)
-        response_data = self._get_response_json(response)
+        response_data = self._get_response_json(response, request_id=request_id)
         cached_parser = self._get_cached_parser(return_type)
         try:
             data = response_data["data"]
             return cached_parser.parse_api(data)
         except (ValueError, JSONDecodeError, KeyError) as e:
-            raise SDKError("unable to process response") from e
+            raise SDKError("unable to process response", request_id=request_id) from e
 
     def _get_cached_parser(self, data_type: type[DT]) -> CachedParser[DT]:
         if data_type not in self._parser_map:
@@ -213,8 +219,9 @@ class Client(ClientMethods):
                     "scope": oauth_details.scope,
                     "grant_type": "client_credentials",
                 },
+                verify=not self._cfg.allow_insecure_tls,
             )
-            data = self._get_response_json(response)
+            data = self._get_response_json(response, request_id=str(uuid4()))
             token_data = oauth_bearer_token_data_parser.parse_storage(data)
             self._oauth_bearer_token_cache = OAuthBearerTokenCache(
                 token=token_data.access_token,
@@ -235,8 +242,11 @@ class Client(ClientMethods):
                 return {"Authorization": f"Bearer {token}"}
         typing.assert_never(self._auth_details)
 
-    def _build_http_request(self, *, api_request: APIRequest) -> HTTPRequest:
+    def _build_http_request(
+        self, *, api_request: APIRequest, request_id: str
+    ) -> HTTPRequest:
         headers = self._build_auth_headers()
+        headers[UNC_REQUEST_ID_HEADER] = request_id
         method = api_request.method.lower()
         data = {"data": json.dumps(serialize_for_api(api_request.args))}
         match method: