feat(api): add external_key_id to projects, email/metadata params to users, update types

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 233
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-ea3c8bfb9cc34e798c5a473bb68ab5012344b1c99ab95377d0af4d908eb32a5d.yml
-openapi_spec_hash: dbab3fdd7781b449ba3e9e1b5180c6ed
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-9a3e2bb9ea36990c39d7b633e6c10eb63d8918080560640a5b4cdccfac164761.yml
+openapi_spec_hash: 0fa82e4dacd57a6d551e79d745860eb8
 config_hash: 5d8a716125a61761563abbfc0d34e57c

src/openai/resources/admin/organization/projects/projects.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import Literal
+from typing import Optional
 
 import httpx
 
@@ -128,7 +128,8 @@ def create(
         self,
         *,
         name: str,
-        geography: Literal["US", "EU", "JP", "IN", "KR", "CA", "AU", "SG"] | Omit = omit,
+        external_key_id: Optional[str] | Omit = omit,
+        geography: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -144,6 +145,8 @@ def create(
         Args:
           name: The friendly name of the project, this name appears in reports.
 
+          external_key_id: External key ID to associate with the project.
+
           geography: Create the project with the specified data residency region. Your organization
               must have access to Data residency functionality in order to use. See
               [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
@@ -162,6 +165,7 @@ def create(
             body=maybe_transform(
                 {
                     "name": name,
+                    "external_key_id": external_key_id,
                     "geography": geography,
                 },
                 project_create_params.ProjectCreateParams,
@@ -217,7 +221,9 @@ def update(
         self,
         project_id: str,
         *,
-        name: str,
+        external_key_id: Optional[str] | Omit = omit,
+        geography: Optional[str] | Omit = omit,
+        name: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -229,6 +235,10 @@ def update(
         Modifies a project in the organization.
 
         Args:
+          external_key_id: External key ID to associate with the project.
+
+          geography: Geography for the project.
+
           name: The updated name of the project, this name appears in reports.
 
           extra_headers: Send extra headers
@@ -243,7 +253,14 @@ def update(
             raise ValueError(f"Expected a non-empty value for `project_id` but received {project_id!r}")
         return self._post(
             path_template("/organization/projects/{project_id}", project_id=project_id),
-            body=maybe_transform({"name": name}, project_update_params.ProjectUpdateParams),
+            body=maybe_transform(
+                {
+                    "external_key_id": external_key_id,
+                    "geography": geography,
+                    "name": name,
+                },
+                project_update_params.ProjectUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -404,7 +421,8 @@ async def create(
         self,
         *,
         name: str,
-        geography: Literal["US", "EU", "JP", "IN", "KR", "CA", "AU", "SG"] | Omit = omit,
+        external_key_id: Optional[str] | Omit = omit,
+        geography: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -420,6 +438,8 @@ async def create(
         Args:
           name: The friendly name of the project, this name appears in reports.
 
+          external_key_id: External key ID to associate with the project.
+
           geography: Create the project with the specified data residency region. Your organization
               must have access to Data residency functionality in order to use. See
               [data residency controls](https://platform.openai.com/docs/guides/your-data#data-residency-controls)
@@ -438,6 +458,7 @@ async def create(
             body=await async_maybe_transform(
                 {
                     "name": name,
+                    "external_key_id": external_key_id,
                     "geography": geography,
                 },
                 project_create_params.ProjectCreateParams,
@@ -493,7 +514,9 @@ async def update(
         self,
         project_id: str,
         *,
-        name: str,
+        external_key_id: Optional[str] | Omit = omit,
+        geography: Optional[str] | Omit = omit,
+        name: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -505,6 +528,10 @@ async def update(
         Modifies a project in the organization.
 
         Args:
+          external_key_id: External key ID to associate with the project.
+
+          geography: Geography for the project.
+
           name: The updated name of the project, this name appears in reports.
 
           extra_headers: Send extra headers
@@ -519,7 +546,14 @@ async def update(
             raise ValueError(f"Expected a non-empty value for `project_id` but received {project_id!r}")
         return await self._post(
             path_template("/organization/projects/{project_id}", project_id=project_id),
-            body=await async_maybe_transform({"name": name}, project_update_params.ProjectUpdateParams),
+            body=await async_maybe_transform(
+                {
+                    "external_key_id": external_key_id,
+                    "geography": geography,
+                    "name": name,
+                },
+                project_update_params.ProjectUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,

src/openai/resources/admin/organization/projects/users/users.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import Literal
+from typing import Optional
 
 import httpx
 
@@ -57,8 +57,9 @@ def create(
         self,
         project_id: str,
         *,
-        role: Literal["owner", "member"],
-        user_id: str,
+        role: str,
+        email: Optional[str] | Omit = omit,
+        user_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -74,6 +75,8 @@ def create(
         Args:
           role: `owner` or `member`
 
+          email: Email of the user to add.
+
           user_id: The ID of the user.
 
           extra_headers: Send extra headers
@@ -91,6 +94,7 @@ def create(
             body=maybe_transform(
                 {
                     "role": role,
+                    "email": email,
                     "user_id": user_id,
                 },
                 user_create_params.UserCreateParams,
@@ -152,7 +156,7 @@ def update(
         user_id: str,
         *,
         project_id: str,
-        role: Literal["owner", "member"],
+        role: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -322,8 +326,9 @@ async def create(
         self,
         project_id: str,
         *,
-        role: Literal["owner", "member"],
-        user_id: str,
+        role: str,
+        email: Optional[str] | Omit = omit,
+        user_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -339,6 +344,8 @@ async def create(
         Args:
           role: `owner` or `member`
 
+          email: Email of the user to add.
+
           user_id: The ID of the user.
 
           extra_headers: Send extra headers
@@ -356,6 +363,7 @@ async def create(
             body=await async_maybe_transform(
                 {
                     "role": role,
+                    "email": email,
                     "user_id": user_id,
                 },
                 user_create_params.UserCreateParams,
@@ -417,7 +425,7 @@ async def update(
         user_id: str,
         *,
         project_id: str,
-        role: Literal["owner", "member"],
+        role: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,

src/openai/resources/admin/organization/users/users.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing_extensions import Literal
+from typing import Optional
 
 import httpx
 
@@ -94,7 +94,10 @@ def update(
         self,
         user_id: str,
         *,
-        role: Literal["owner", "reader"] | Omit = omit,
+        developer_persona: Optional[str] | Omit = omit,
+        role: Optional[str] | Omit = omit,
+        role_id: Optional[str] | Omit = omit,
+        technical_level: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -106,8 +109,14 @@ def update(
         Modifies a user's role in the organization.
 
         Args:
+          developer_persona: Developer persona metadata.
+
           role: `owner` or `reader`
 
+          role_id: Role ID to assign to the user.
+
+          technical_level: Technical level metadata.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -120,7 +129,15 @@ def update(
             raise ValueError(f"Expected a non-empty value for `user_id` but received {user_id!r}")
         return self._post(
             path_template("/organization/users/{user_id}", user_id=user_id),
-            body=maybe_transform({"role": role}, user_update_params.UserUpdateParams),
+            body=maybe_transform(
+                {
+                    "developer_persona": developer_persona,
+                    "role": role,
+                    "role_id": role_id,
+                    "technical_level": technical_level,
+                },
+                user_update_params.UserUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -290,7 +307,10 @@ async def update(
         self,
         user_id: str,
         *,
-        role: Literal["owner", "reader"] | Omit = omit,
+        developer_persona: Optional[str] | Omit = omit,
+        role: Optional[str] | Omit = omit,
+        role_id: Optional[str] | Omit = omit,
+        technical_level: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -302,8 +322,14 @@ async def update(
         Modifies a user's role in the organization.
 
         Args:
+          developer_persona: Developer persona metadata.
+
           role: `owner` or `reader`
 
+          role_id: Role ID to assign to the user.
+
+          technical_level: Technical level metadata.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -316,7 +342,15 @@ async def update(
             raise ValueError(f"Expected a non-empty value for `user_id` but received {user_id!r}")
         return await self._post(
             path_template("/organization/users/{user_id}", user_id=user_id),
-            body=await async_maybe_transform({"role": role}, user_update_params.UserUpdateParams),
+            body=await async_maybe_transform(
+                {
+                    "developer_persona": developer_persona,
+                    "role": role,
+                    "role_id": role_id,
+                    "technical_level": technical_level,
+                },
+                user_update_params.UserUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,

src/openai/types/admin/organization/admin_api_key.py

@@ -37,12 +37,6 @@ class AdminAPIKey(BaseModel):
     created_at: int
     """The Unix timestamp (in seconds) of when the API key was created"""
 
-    last_used_at: Optional[int] = None
-    """The Unix timestamp (in seconds) of when the API key was last used"""
-
-    name: str
-    """The name of the API key"""
-
     object: Literal["organization.admin_api_key"]
     """The object type, which is always `organization.admin_api_key`"""
 
@@ -51,5 +45,8 @@ class AdminAPIKey(BaseModel):
     redacted_value: str
     """The redacted value of the API key"""
 
-    value: Optional[str] = None
-    """The value of the API key. Only shown on create."""
+    last_used_at: Optional[int] = None
+    """The Unix timestamp (in seconds) of when the API key was last used"""
+
+    name: Optional[str] = None
+    """The name of the API key"""

src/openai/types/admin/organization/admin_api_key_create_response.py

@@ -8,5 +8,5 @@
 class AdminAPIKeyCreateResponse(AdminAPIKey):
     """Represents an individual Admin API key in an org."""
 
-    value: str  # type: ignore
+    value: str
     """The value of the API key. Only shown on create."""

src/openai/types/admin/organization/group.py

@@ -14,6 +14,9 @@ class Group(BaseModel):
     created_at: int
     """Unix timestamp (in seconds) when the group was created."""
 
+    group_type: str
+    """The type of the group."""
+
     is_scim_managed: bool
     """
     Whether the group is managed through SCIM and controlled by your identity