Update api spec (#531)

* YOYO NEW API SPEC!

* I have generated the latest API!

---------

Co-authored-by: zoo-github-actions-auth[bot] <zoo-github-actions-auth[bot]@users.noreply.github.com>

Author: zoo-github-actions-auth[bot]

kittycad.py.patch.json

@@ -351,6 +351,14 @@
       "libDocsLink": "https://python.api.docs.zoo.dev/_autosummary/kittycad.KittyCAD.html#kittycad.KittyCAD.orgs"
     }
   },
+  {
+    "op": "add",
+    "path": "/paths/~1orgs~1{id}~1admin~1details/get/x-python",
+    "value": {
+      "example": "from kittycad.models.uuid import Uuid\nfrom kittycad.models.uuid import Uuid\nfrom kittycad.models import OrgAdminDetails\nfrom typing import Union, Any, Optional, List, Tuple\nfrom kittycad.types import Response\ndef example_org_admin_details_get():\n    client = KittyCAD()  # Uses KITTYCAD_API_TOKEN environment variable\n\n    result: OrgAdminDetails = client.orgs.org_admin_details_get(id=Uuid(\"<string>\"))\n\n\n    body: OrgAdminDetails = result\n    print(body)\n\n",
+      "libDocsLink": "https://python.api.docs.zoo.dev/_autosummary/kittycad.KittyCAD.html#kittycad.KittyCAD.orgs"
+    }
+  },
   {
     "op": "add",
     "path": "/paths/~1orgs~1{id}~1enterprise~1pricing/put/x-python",
@@ -807,6 +815,14 @@
       "libDocsLink": "https://python.api.docs.zoo.dev/_autosummary/kittycad.KittyCAD.html#kittycad.KittyCAD.users"
     }
   },
+  {
+    "op": "add",
+    "path": "/paths/~1users~1{id}~1admin~1details/get/x-python",
+    "value": {
+      "example": "from kittycad.models.user_identifier import UserIdentifier\nfrom kittycad.models import UserAdminDetails\nfrom typing import Union, Any, Optional, List, Tuple\nfrom kittycad.types import Response\ndef example_user_admin_details_get():\n    client = KittyCAD()  # Uses KITTYCAD_API_TOKEN environment variable\n\n    result: UserAdminDetails = client.users.user_admin_details_get(id=UserIdentifier(\"<string>\"))\n\n\n    body: UserAdminDetails = result\n    print(body)\n\n",
+      "libDocsLink": "https://python.api.docs.zoo.dev/_autosummary/kittycad.KittyCAD.html#kittycad.KittyCAD.users"
+    }
+  },
   {
     "op": "add",
     "path": "/paths/~1users~1{id}~1api-calls/get/x-python",

kittycad/__init__.py

@@ -91,6 +91,7 @@
 from .models.ml_prompt_results_page import MlPromptResultsPage
 from .models.oauth2_client_info import OAuth2ClientInfo
 from .models.org import Org
+from .models.org_admin_details import OrgAdminDetails
 from .models.org_details import OrgDetails
 from .models.org_member import OrgMember
 from .models.org_member_results_page import OrgMemberResultsPage
@@ -153,6 +154,7 @@
 from .models.update_shortlink_request import UpdateShortlinkRequest
 from .models.update_user import UpdateUser
 from .models.user import User
+from .models.user_admin_details import UserAdminDetails
 from .models.user_identifier import UserIdentifier
 from .models.user_org_info import UserOrgInfo
 from .models.user_org_role import UserOrgRole
@@ -6101,6 +6103,34 @@ def get_any_org(
         # Validate into a Pydantic model (works for BaseModel and RootModel)
         return Org.model_validate(json_data)
 
+    def org_admin_details_get(
+        self,
+        id: Uuid,
+    ) -> OrgAdminDetails:
+        """Zoo admins can retrieve extended information about any organization, while non-admins receive a 404 to avoid leaking existence."""
+
+        url = "{}/orgs/{id}/admin/details".format(self.client.base_url, id=id)
+
+        _client = self.client.get_http_client()
+
+        response = _client.get(
+            url=url,
+            headers=self.client.get_headers(),
+        )
+
+        if not response.is_success:
+            from ..response_helpers import raise_for_status
+
+            raise_for_status(response)
+
+        if not response.content:
+            return None  # type: ignore
+
+        json_data = response.json()
+
+        # Validate into a Pydantic model (works for BaseModel and RootModel)
+        return OrgAdminDetails.model_validate(json_data)
+
     def update_enterprise_pricing_for_org(
         self,
         id: Uuid,
@@ -6858,6 +6888,34 @@ async def get_any_org(
         # Validate into a Pydantic model (works for BaseModel and RootModel)
         return Org.model_validate(json_data)
 
+    async def org_admin_details_get(
+        self,
+        id: Uuid,
+    ) -> OrgAdminDetails:
+        """Zoo admins can retrieve extended information about any organization, while non-admins receive a 404 to avoid leaking existence."""
+
+        url = "{}/orgs/{id}/admin/details".format(self.client.base_url, id=id)
+
+        _client = self.client.get_http_client()
+
+        response = await _client.get(
+            url=url,
+            headers=self.client.get_headers(),
+        )
+
+        if not response.is_success:
+            from ..response_helpers import raise_for_status
+
+            raise_for_status(response)
+
+        if not response.content:
+            return None  # type: ignore
+
+        json_data = response.json()
+
+        # Validate into a Pydantic model (works for BaseModel and RootModel)
+        return OrgAdminDetails.model_validate(json_data)
+
     async def update_enterprise_pricing_for_org(
         self,
         id: Uuid,
@@ -10706,6 +10764,34 @@ def get_user(
         # Validate into a Pydantic model (works for BaseModel and RootModel)
         return User.model_validate(json_data)
 
+    def user_admin_details_get(
+        self,
+        id: UserIdentifier,
+    ) -> UserAdminDetails:
+        """Zoo admins can retrieve extended information about any user, while non-admins receive a 404 to avoid leaking the existence of the resource."""
+
+        url = "{}/users/{id}/admin/details".format(self.client.base_url, id=id)
+
+        _client = self.client.get_http_client()
+
+        response = _client.get(
+            url=url,
+            headers=self.client.get_headers(),
+        )
+
+        if not response.is_success:
+            from ..response_helpers import raise_for_status
+
+            raise_for_status(response)
+
+        if not response.content:
+            return None  # type: ignore
+
+        json_data = response.json()
+
+        # Validate into a Pydantic model (works for BaseModel and RootModel)
+        return UserAdminDetails.model_validate(json_data)
+
     def update_subscription_for_user(
         self,
         id: UserIdentifier,
@@ -11461,6 +11547,34 @@ async def get_user(
         # Validate into a Pydantic model (works for BaseModel and RootModel)
         return User.model_validate(json_data)
 
+    async def user_admin_details_get(
+        self,
+        id: UserIdentifier,
+    ) -> UserAdminDetails:
+        """Zoo admins can retrieve extended information about any user, while non-admins receive a 404 to avoid leaking the existence of the resource."""
+
+        url = "{}/users/{id}/admin/details".format(self.client.base_url, id=id)
+
+        _client = self.client.get_http_client()
+
+        response = await _client.get(
+            url=url,
+            headers=self.client.get_headers(),
+        )
+
+        if not response.is_success:
+            from ..response_helpers import raise_for_status
+
+            raise_for_status(response)
+
+        if not response.content:
+            return None  # type: ignore
+
+        json_data = response.json()
+
+        # Validate into a Pydantic model (works for BaseModel and RootModel)
+        return UserAdminDetails.model_validate(json_data)
+
     async def update_subscription_for_user(
         self,
         id: UserIdentifier,

kittycad/models/__init__.py

@@ -3,6 +3,7 @@
 from .account_provider import AccountProvider
 from .add_hole_from_offset import AddHoleFromOffset
 from .add_org_member import AddOrgMember
+from .address import Address
 from .address_details import AddressDetails
 from .adjacency_info import AdjacencyInfo
 from .angle import Angle
@@ -236,6 +237,8 @@
 from .opposite_for_angle import OppositeForAngle
 from .opposite_for_length_unit import OppositeForLengthUnit
 from .org import Org
+from .org_address import OrgAddress
+from .org_admin_details import OrgAdminDetails
 from .org_details import OrgDetails
 from .org_member import OrgMember
 from .org_member_results_page import OrgMemberResultsPage
@@ -394,6 +397,7 @@
 from .update_shortlink_request import UpdateShortlinkRequest
 from .update_user import UpdateUser
 from .user import User
+from .user_admin_details import UserAdminDetails
 from .user_identifier import UserIdentifier
 from .user_org_info import UserOrgInfo
 from .user_org_role import UserOrgRole

kittycad/models/address.py

@@ -0,0 +1,30 @@
+import datetime
+from typing import Optional
+
+from ..models.country_code import CountryCode
+from ..models.uuid import Uuid
+from .base import KittyCadBaseModel
+
+
+class Address(KittyCadBaseModel):
+    """An address for a user."""
+
+    city: Optional[str] = None
+
+    country: CountryCode
+
+    created_at: datetime.datetime
+
+    id: Uuid
+
+    state: Optional[str] = None
+
+    street1: Optional[str] = None
+
+    street2: Optional[str] = None
+
+    updated_at: datetime.datetime
+
+    user_id: Uuid
+
+    zip: Optional[str] = None

kittycad/models/org_address.py

@@ -0,0 +1,30 @@
+import datetime
+from typing import Optional
+
+from ..models.country_code import CountryCode
+from ..models.uuid import Uuid
+from .base import KittyCadBaseModel
+
+
+class OrgAddress(KittyCadBaseModel):
+    """An address for an organization."""
+
+    city: Optional[str] = None
+
+    country: CountryCode
+
+    created_at: datetime.datetime
+
+    id: Uuid
+
+    org_id: Uuid
+
+    state: Optional[str] = None
+
+    street1: Optional[str] = None
+
+    street2: Optional[str] = None
+
+    updated_at: datetime.datetime
+
+    zip: Optional[str] = None

kittycad/models/org_admin_details.py

@@ -0,0 +1,26 @@
+from typing import List, Optional
+
+from ..models.block_reason import BlockReason
+from ..models.org_address import OrgAddress
+from ..models.payment_method import PaymentMethod
+from .base import KittyCadBaseModel
+
+
+class OrgAdminDetails(KittyCadBaseModel):
+    """Extra admin-only details for an organization."""
+
+    address: Optional[OrgAddress] = None
+
+    address_summary: Optional[str] = None
+
+    block: Optional[BlockReason] = None
+
+    block_message: Optional[str] = None
+
+    payment_methods: List[PaymentMethod]
+
+    payment_methods_summary: List[str]
+
+    stripe_customer_id: Optional[str] = None
+
+    stripe_dashboard_url: Optional[str] = None

kittycad/models/user_admin_details.py

@@ -0,0 +1,28 @@
+from typing import List, Optional
+
+from ..models.address import Address
+from ..models.block_reason import BlockReason
+from ..models.payment_method import PaymentMethod
+from .base import KittyCadBaseModel
+
+
+class UserAdminDetails(KittyCadBaseModel):
+    """Extra admin-only details for a user."""
+
+    address: Optional[Address] = None
+
+    address_summary: Optional[str] = None
+
+    block: Optional[BlockReason] = None
+
+    block_message: Optional[str] = None
+
+    hubspot_contact_url: Optional[str] = None
+
+    payment_methods: List[PaymentMethod]
+
+    payment_methods_summary: List[str]
+
+    stripe_customer_id: Optional[str] = None
+
+    stripe_dashboard_url: Optional[str] = None