autoassembler 0.3.1__py3-none-any.whl

autoassembler/assemblies/raw_client.py

@@ -0,0 +1,1557 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import contextlib
+import typing
+from json.decoder import JSONDecodeError
+
+from .. import core
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.jsonable_encoder import encode_path_param
+from ..core.parse_error import ParsingError
+from ..core.pydantic_utilities import parse_obj_as
+from ..core.request_options import RequestOptions
+from ..core.serialization import convert_and_respect_annotation_metadata
+from ..errors.bad_request_error import BadRequestError
+from ..errors.forbidden_error import ForbiddenError
+from ..errors.not_found_error import NotFoundError
+from ..types.assembly import Assembly
+from ..types.assembly_connections_response import AssemblyConnectionsResponse
+from ..types.assembly_info import AssemblyInfo
+from ..types.assembly_json_response import AssemblyJsonResponse
+from ..types.assembly_version_summary import AssemblyVersionSummary
+from ..types.diff_report import DiffReport
+from ..types.error_response import ErrorResponse
+from ..types.filter import Filter
+from ..types.process_assembly_response import ProcessAssemblyResponse
+from ..types.search_assemblies_response import SearchAssembliesResponse
+from ..types.sort import Sort
+from ..types.upload_response import UploadResponse
+from .types.delete_assembly_response import DeleteAssemblyResponse
+from .types.download_assembly_cad_request_namespace import DownloadAssemblyCadRequestNamespace
+from .types.get_assembly_info_request_namespace import GetAssemblyInfoRequestNamespace
+from .types.get_status_request_namespace import GetStatusRequestNamespace
+from .types.get_status_response import GetStatusResponse
+from .types.get_structure_request_namespace import GetStructureRequestNamespace
+from .types.list_assembly_versions_request_namespace import ListAssemblyVersionsRequestNamespace
+from .types.list_connections_request_namespace import ListConnectionsRequestNamespace
+from .types.process_request_namespace import ProcessRequestNamespace
+from .types.update_assembly_info_request_namespace import UpdateAssemblyInfoRequestNamespace
+from pydantic import ValidationError
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawAssembliesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def upload(
+        self, *, file: typing.Optional[core.File] = OMIT, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[UploadResponse]:
+        """
+        Parameters
+        ----------
+        file : typing.Optional[core.File]
+            See core.File for more documentation
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[UploadResponse]
+            Successful upload
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v4/assemblies",
+            method="POST",
+            data={},
+            files={
+                **({"file": file} if file is not None else {}),
+            },
+            request_options=request_options,
+            omit=OMIT,
+            force_multipart=True,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    UploadResponse,
+                    parse_obj_as(
+                        type_=UploadResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def search(
+        self,
+        *,
+        offset: typing.Optional[int] = OMIT,
+        limit: typing.Optional[int] = OMIT,
+        filters: typing.Optional[typing.Sequence[Filter]] = OMIT,
+        sort: typing.Optional[Sort] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[SearchAssembliesResponse]:
+        """
+        Parameters
+        ----------
+        offset : typing.Optional[int]
+
+        limit : typing.Optional[int]
+
+        filters : typing.Optional[typing.Sequence[Filter]]
+
+        sort : typing.Optional[Sort]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[SearchAssembliesResponse]
+            Search results
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v4/assemblies/search",
+            method="POST",
+            json={
+                "offset": offset,
+                "limit": limit,
+                "filters": convert_and_respect_annotation_metadata(
+                    object_=filters, annotation=typing.Sequence[Filter], direction="write"
+                ),
+                "sort": sort,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    SearchAssembliesResponse,
+                    parse_obj_as(
+                        type_=SearchAssembliesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def diff(
+        self,
+        *,
+        reference_id: str,
+        target_id: str,
+        context_n_hops: typing.Optional[int] = OMIT,
+        async_: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[DiffReport]:
+        """
+        Compares a baseline assembly (`referenceId`) with another assembly
+        revision (`targetId`) and returns a structured report describing what
+        changed.
+
+        Typical UI mapping:
+        - Use `summary` for aggregate counts and badges.
+        - Use `details.geomDiffNodes.reference` for parts present only in the baseline.
+        - Use `details.geomDiffNodes.target` for parts present only in the target.
+        - Use `details.movedPosePairs` for matching parts that changed position or orientation.
+        - Use `details.swaps` for likely replacements, swaps, or renamed parts.
+        - Treat `flags` as supporting metadata for explanations, filters, or diagnostics.
+
+        Set `async` to `true` to get `202` with the operation computing the diff
+        (AIP-151): poll `GET /api/v4/operations/{id}` until it is `done`, then fetch
+        `resultUrl` for the `DiffReport`.
+
+        **Deprecated:** calling without `async: true`, which blocks until the diff is
+        computed and answers `200` with the report, with a `Deprecation` header
+        (RFC 9745). Pass `async: true` and wait on the operation instead; a later
+        version will always answer `202`.
+
+        Parameters
+        ----------
+        reference_id : str
+            Baseline assembly ID.
+
+        target_id : str
+            Target assembly ID.
+
+        context_n_hops : typing.Optional[int]
+            Graph radius used to collect surviving parts that define each added, removed, or swapped part's liaison context.
+
+        async_ : typing.Optional[bool]
+            When true, queues the diff and returns 202 with the operation computing it. Omitting it (or `false`) is deprecated.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[DiffReport]
+            Deprecated: the diff report, when called without `async: true`. Pass `async: true` and wait on the operation instead.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "api/v4/assemblies/diff",
+            method="POST",
+            json={
+                "referenceId": reference_id,
+                "targetId": target_id,
+                "contextNHops": context_n_hops,
+                "async": async_,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DiffReport,
+                    parse_obj_as(
+                        type_=DiffReport,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def delete_assembly(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[DeleteAssemblyResponse]:
+        """
+        Parameters
+        ----------
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[DeleteAssemblyResponse]
+            Assembly deleted successfully
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(id)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DeleteAssemblyResponse,
+                    parse_obj_as(
+                        type_=DeleteAssemblyResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def process(
+        self,
+        namespace: ProcessRequestNamespace,
+        id: str,
+        *,
+        attributes: typing.Optional[typing.Dict[str, typing.Sequence[str]]] = OMIT,
+        force: typing.Optional[bool] = OMIT,
+        clear_cache: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[ProcessAssemblyResponse]:
+        """
+        Parameters
+        ----------
+        namespace : ProcessRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        attributes : typing.Optional[typing.Dict[str, typing.Sequence[str]]]
+            Attribute patterns for marking occurrences during parsing. Keys are attribute names (e.g. `consolidated`); values are glob patterns.
+
+        force : typing.Optional[bool]
+            Force reprocessing even if already processed.
+
+        clear_cache : typing.Optional[bool]
+            Clear cached planning data for this assembly.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[ProcessAssemblyResponse]
+            Processing request accepted or skipped
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/process",
+            method="POST",
+            json={
+                "attributes": attributes,
+                "force": force,
+                "clearCache": clear_cache,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    ProcessAssemblyResponse,
+                    parse_obj_as(
+                        type_=ProcessAssemblyResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def get_status(
+        self, namespace: GetStatusRequestNamespace, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[GetStatusResponse]:
+        """
+        Parameters
+        ----------
+        namespace : GetStatusRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[GetStatusResponse]
+            Current processing status of the assembly
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/status.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetStatusResponse,
+                    parse_obj_as(
+                        type_=GetStatusResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def get_structure(
+        self,
+        namespace: GetStructureRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[AssemblyJsonResponse]:
+        """
+        Parameters
+        ----------
+        namespace : GetStructureRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[AssemblyJsonResponse]
+            Assembly metadata and structure.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/assembly.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AssemblyJsonResponse,
+                    parse_obj_as(
+                        type_=AssemblyJsonResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def list_connections(
+        self,
+        namespace: ListConnectionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[AssemblyConnectionsResponse]:
+        """
+        Returns physical connections between occurrences. Each connection is a contact or interference relationship.
+
+        Parameters
+        ----------
+        namespace : ListConnectionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[AssemblyConnectionsResponse]
+            Assembly connections.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/connections.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AssemblyConnectionsResponse,
+                    parse_obj_as(
+                        type_=AssemblyConnectionsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def get_assembly_info(
+        self,
+        namespace: GetAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[AssemblyInfo]:
+        """
+        Parameters
+        ----------
+        namespace : GetAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[AssemblyInfo]
+            Assembly metadata fields.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/info.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AssemblyInfo,
+                    parse_obj_as(
+                        type_=AssemblyInfo,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def update_assembly_info(
+        self,
+        namespace: UpdateAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[Assembly]:
+        """
+        Currently only `name` is writable.
+
+        Parameters
+        ----------
+        namespace : UpdateAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        name : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[Assembly]
+            Updated assembly record.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/info.json",
+            method="PUT",
+            json={
+                "name": name,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Assembly,
+                    parse_obj_as(
+                        type_=Assembly,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def list_assembly_versions(
+        self,
+        namespace: ListAssemblyVersionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[typing.List[AssemblyVersionSummary]]:
+        """
+        Returns other assemblies that share this assembly's `externalId` (for example an Onshape document). Empty when `externalId` is unset.
+
+        Parameters
+        ----------
+        namespace : ListAssemblyVersionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[typing.List[AssemblyVersionSummary]]
+            Version list.
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/versions.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    typing.List[AssemblyVersionSummary],
+                    parse_obj_as(
+                        type_=typing.List[AssemblyVersionSummary],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    @contextlib.contextmanager
+    def download_assembly_cad(
+        self,
+        namespace: DownloadAssemblyCadRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Iterator[HttpResponse[typing.Iterator[bytes]]]:
+        """
+        Parameters
+        ----------
+        namespace : DownloadAssemblyCadRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
+
+        Returns
+        -------
+        typing.Iterator[HttpResponse[typing.Iterator[bytes]]]
+            CAD file bytes (attachment download).
+        """
+        with self._client_wrapper.httpx_client.stream(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/download",
+            method="GET",
+            request_options=request_options,
+        ) as _response:
+
+            def _stream() -> HttpResponse[typing.Iterator[bytes]]:
+                try:
+                    if 200 <= _response.status_code < 300:
+                        _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
+                        return HttpResponse(
+                            response=_response, data=(_chunk for _chunk in _response.iter_bytes(chunk_size=_chunk_size))
+                        )
+                    _response.read()
+                    if _response.status_code == 404:
+                        raise NotFoundError(
+                            headers=dict(_response.headers),
+                            body=typing.cast(
+                                ErrorResponse,
+                                parse_obj_as(
+                                    type_=ErrorResponse,  # type: ignore
+                                    object_=_response.json(),
+                                ),
+                            ),
+                        )
+                    _response_json = _response.json()
+                except JSONDecodeError:
+                    raise ApiError(
+                        status_code=_response.status_code, headers=dict(_response.headers), body=_response.text
+                    )
+                except ValidationError as e:
+                    raise ParsingError(
+                        status_code=_response.status_code,
+                        headers=dict(_response.headers),
+                        body=_response.json(),
+                        cause=e,
+                    )
+                raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+            yield _stream()
+
+
+class AsyncRawAssembliesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def upload(
+        self, *, file: typing.Optional[core.File] = OMIT, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[UploadResponse]:
+        """
+        Parameters
+        ----------
+        file : typing.Optional[core.File]
+            See core.File for more documentation
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[UploadResponse]
+            Successful upload
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v4/assemblies",
+            method="POST",
+            data={},
+            files={
+                **({"file": file} if file is not None else {}),
+            },
+            request_options=request_options,
+            omit=OMIT,
+            force_multipart=True,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    UploadResponse,
+                    parse_obj_as(
+                        type_=UploadResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def search(
+        self,
+        *,
+        offset: typing.Optional[int] = OMIT,
+        limit: typing.Optional[int] = OMIT,
+        filters: typing.Optional[typing.Sequence[Filter]] = OMIT,
+        sort: typing.Optional[Sort] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[SearchAssembliesResponse]:
+        """
+        Parameters
+        ----------
+        offset : typing.Optional[int]
+
+        limit : typing.Optional[int]
+
+        filters : typing.Optional[typing.Sequence[Filter]]
+
+        sort : typing.Optional[Sort]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[SearchAssembliesResponse]
+            Search results
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v4/assemblies/search",
+            method="POST",
+            json={
+                "offset": offset,
+                "limit": limit,
+                "filters": convert_and_respect_annotation_metadata(
+                    object_=filters, annotation=typing.Sequence[Filter], direction="write"
+                ),
+                "sort": sort,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    SearchAssembliesResponse,
+                    parse_obj_as(
+                        type_=SearchAssembliesResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def diff(
+        self,
+        *,
+        reference_id: str,
+        target_id: str,
+        context_n_hops: typing.Optional[int] = OMIT,
+        async_: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[DiffReport]:
+        """
+        Compares a baseline assembly (`referenceId`) with another assembly
+        revision (`targetId`) and returns a structured report describing what
+        changed.
+
+        Typical UI mapping:
+        - Use `summary` for aggregate counts and badges.
+        - Use `details.geomDiffNodes.reference` for parts present only in the baseline.
+        - Use `details.geomDiffNodes.target` for parts present only in the target.
+        - Use `details.movedPosePairs` for matching parts that changed position or orientation.
+        - Use `details.swaps` for likely replacements, swaps, or renamed parts.
+        - Treat `flags` as supporting metadata for explanations, filters, or diagnostics.
+
+        Set `async` to `true` to get `202` with the operation computing the diff
+        (AIP-151): poll `GET /api/v4/operations/{id}` until it is `done`, then fetch
+        `resultUrl` for the `DiffReport`.
+
+        **Deprecated:** calling without `async: true`, which blocks until the diff is
+        computed and answers `200` with the report, with a `Deprecation` header
+        (RFC 9745). Pass `async: true` and wait on the operation instead; a later
+        version will always answer `202`.
+
+        Parameters
+        ----------
+        reference_id : str
+            Baseline assembly ID.
+
+        target_id : str
+            Target assembly ID.
+
+        context_n_hops : typing.Optional[int]
+            Graph radius used to collect surviving parts that define each added, removed, or swapped part's liaison context.
+
+        async_ : typing.Optional[bool]
+            When true, queues the diff and returns 202 with the operation computing it. Omitting it (or `false`) is deprecated.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[DiffReport]
+            Deprecated: the diff report, when called without `async: true`. Pass `async: true` and wait on the operation instead.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/v4/assemblies/diff",
+            method="POST",
+            json={
+                "referenceId": reference_id,
+                "targetId": target_id,
+                "contextNHops": context_n_hops,
+                "async": async_,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DiffReport,
+                    parse_obj_as(
+                        type_=DiffReport,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def delete_assembly(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[DeleteAssemblyResponse]:
+        """
+        Parameters
+        ----------
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[DeleteAssemblyResponse]
+            Assembly deleted successfully
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(id)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    DeleteAssemblyResponse,
+                    parse_obj_as(
+                        type_=DeleteAssemblyResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def process(
+        self,
+        namespace: ProcessRequestNamespace,
+        id: str,
+        *,
+        attributes: typing.Optional[typing.Dict[str, typing.Sequence[str]]] = OMIT,
+        force: typing.Optional[bool] = OMIT,
+        clear_cache: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[ProcessAssemblyResponse]:
+        """
+        Parameters
+        ----------
+        namespace : ProcessRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        attributes : typing.Optional[typing.Dict[str, typing.Sequence[str]]]
+            Attribute patterns for marking occurrences during parsing. Keys are attribute names (e.g. `consolidated`); values are glob patterns.
+
+        force : typing.Optional[bool]
+            Force reprocessing even if already processed.
+
+        clear_cache : typing.Optional[bool]
+            Clear cached planning data for this assembly.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[ProcessAssemblyResponse]
+            Processing request accepted or skipped
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/process",
+            method="POST",
+            json={
+                "attributes": attributes,
+                "force": force,
+                "clearCache": clear_cache,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    ProcessAssemblyResponse,
+                    parse_obj_as(
+                        type_=ProcessAssemblyResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 403:
+                raise ForbiddenError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ErrorResponse,
+                        parse_obj_as(
+                            type_=ErrorResponse,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def get_status(
+        self, namespace: GetStatusRequestNamespace, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[GetStatusResponse]:
+        """
+        Parameters
+        ----------
+        namespace : GetStatusRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[GetStatusResponse]
+            Current processing status of the assembly
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/status.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetStatusResponse,
+                    parse_obj_as(
+                        type_=GetStatusResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def get_structure(
+        self,
+        namespace: GetStructureRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[AssemblyJsonResponse]:
+        """
+        Parameters
+        ----------
+        namespace : GetStructureRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[AssemblyJsonResponse]
+            Assembly metadata and structure.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/assembly.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AssemblyJsonResponse,
+                    parse_obj_as(
+                        type_=AssemblyJsonResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def list_connections(
+        self,
+        namespace: ListConnectionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[AssemblyConnectionsResponse]:
+        """
+        Returns physical connections between occurrences. Each connection is a contact or interference relationship.
+
+        Parameters
+        ----------
+        namespace : ListConnectionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[AssemblyConnectionsResponse]
+            Assembly connections.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/connections.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AssemblyConnectionsResponse,
+                    parse_obj_as(
+                        type_=AssemblyConnectionsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def get_assembly_info(
+        self,
+        namespace: GetAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[AssemblyInfo]:
+        """
+        Parameters
+        ----------
+        namespace : GetAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[AssemblyInfo]
+            Assembly metadata fields.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/info.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    AssemblyInfo,
+                    parse_obj_as(
+                        type_=AssemblyInfo,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def update_assembly_info(
+        self,
+        namespace: UpdateAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[Assembly]:
+        """
+        Currently only `name` is writable.
+
+        Parameters
+        ----------
+        namespace : UpdateAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        name : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[Assembly]
+            Updated assembly record.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/info.json",
+            method="PUT",
+            json={
+                "name": name,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    Assembly,
+                    parse_obj_as(
+                        type_=Assembly,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Any,
+                        parse_obj_as(
+                            type_=typing.Any,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def list_assembly_versions(
+        self,
+        namespace: ListAssemblyVersionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[typing.List[AssemblyVersionSummary]]:
+        """
+        Returns other assemblies that share this assembly's `externalId` (for example an Onshape document). Empty when `externalId` is unset.
+
+        Parameters
+        ----------
+        namespace : ListAssemblyVersionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[typing.List[AssemblyVersionSummary]]
+            Version list.
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/versions.json",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    typing.List[AssemblyVersionSummary],
+                    parse_obj_as(
+                        type_=typing.List[AssemblyVersionSummary],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    @contextlib.asynccontextmanager
+    async def download_assembly_cad(
+        self,
+        namespace: DownloadAssemblyCadRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]:
+        """
+        Parameters
+        ----------
+        namespace : DownloadAssemblyCadRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
+
+        Returns
+        -------
+        typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]
+            CAD file bytes (attachment download).
+        """
+        async with self._client_wrapper.httpx_client.stream(
+            f"api/v4/assemblies/{encode_path_param(namespace)}/{encode_path_param(id)}/download",
+            method="GET",
+            request_options=request_options,
+        ) as _response:
+
+            async def _stream() -> AsyncHttpResponse[typing.AsyncIterator[bytes]]:
+                try:
+                    if 200 <= _response.status_code < 300:
+                        _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
+                        return AsyncHttpResponse(
+                            response=_response,
+                            data=(_chunk async for _chunk in _response.aiter_bytes(chunk_size=_chunk_size)),
+                        )
+                    await _response.aread()
+                    if _response.status_code == 404:
+                        raise NotFoundError(
+                            headers=dict(_response.headers),
+                            body=typing.cast(
+                                ErrorResponse,
+                                parse_obj_as(
+                                    type_=ErrorResponse,  # type: ignore
+                                    object_=_response.json(),
+                                ),
+                            ),
+                        )
+                    _response_json = _response.json()
+                except JSONDecodeError:
+                    raise ApiError(
+                        status_code=_response.status_code, headers=dict(_response.headers), body=_response.text
+                    )
+                except ValidationError as e:
+                    raise ParsingError(
+                        status_code=_response.status_code,
+                        headers=dict(_response.headers),
+                        body=_response.json(),
+                        cause=e,
+                    )
+                raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+            yield await _stream()