UncountablePythonSDK 0.0.24__py3-none-any.whl → 0.0.26__py3-none-any.whl

type_spec/external/api/outputs/get_output_names.yaml

@@ -13,10 +13,10 @@ Arguments:
             desc: "The material family ID to get the output values from"
         offset?:
             type: Integer
-            desc: "Used for pagination, where the number of results returned exceeds the limit. Results are always ordered by the output ID"
+            desc: Used for pagination, where the number of results returned exceeds the limit. Results are always ordered by the output ID. [Pagination More Info](#pagination)
         limit?:
             type: Integer
-            desc: "The maximum number of results to return. By default this is set to 20,000 and it cannot be set higher than 20,000"
+            desc: The maximum number of results to return. By default this is set to 20,000 and it cannot be set higher than 20,000. [Pagination More Info](#pagination)
 
 OutputWithName:
     type: Object

type_spec/external/api/project/get_projects_data.yaml

@@ -12,10 +12,10 @@ Arguments:
             desc: "The projects to get the data from"
         offset?:
             type: Optional<Integer>
-            desc: "Used for pagination. All pagination is done in order of Project ID"
+            desc: Used for pagination. All pagination is done in order of Project ID. [Pagination More Info](#pagination)
         limit?:
             type: Optional<Integer>
-            desc: "The number of data points to return. If not filled in, it will be set to 100, and cannot be set higher than 100"
+            desc: The number of data points to return. If not filled in, it will be set to 100, and cannot be set higher than 100. [Pagination More Info](#pagination)
 
 ProjectDetailed:
     type: Object

type_spec/external/api/recipe_metadata/get_recipe_metadata_data.yaml

@@ -16,10 +16,10 @@ Arguments:
             desc: "The recipe metadata IDs to get the data from. If this is not filled in, all metadata from a material family will be returned (in paginated form)."
         offset?:
             type: Optional<Integer>
-            desc: "Used for pagination, where the number of results returned exceeds the limit. Results are always ordered by the metadata ID"
+            desc: Used for pagination, where the number of results returned exceeds the limit. Results are always ordered by the metadata ID. [Pagination More Info](#pagination)
         limit?:
             type: Optional<Integer>
-            desc: "The maximum number of results to return. By default this is set to 1,000 and it cannot be set higher than 1,000"
+            desc: The maximum number of results to return. By default this is set to 1,000 and it cannot be set higher than 1,000. [Pagination More Info](#pagination)
 
 FullRecipeMetadataField:
     type: Object

type_spec/external/api/recipes/create_recipe.yaml

@@ -16,6 +16,9 @@ Arguments:
         material_family_id:
             type: ObjectId
             desc: The material family for the recipe
+        project_id?:
+            type: ObjectId
+            desc: The identifier of the project to create the recipe in
         workflow_id:
             type: ObjectId
             desc: The identifier of the workflow to create the recipe with

type_spec/external/api/recipes/get_recipes_data.yaml

@@ -15,10 +15,10 @@ Arguments:
             desc: "The projects to get the data from. Either these or recipe_ids must be filled in"
         offset?:
             type: Optional<Integer>
-            desc: "Used for pagination. All pagination is done in order of Recipe ID"
+            desc: Used for pagination. All pagination is done in order of Recipe ID. [Pagination More Info](#pagination)
         limit?:
             type: Optional<Integer>
-            desc: "The number of data points to return. If not filled in, it will be set to 100, and cannot be set higher than 100"
+            desc: The number of data points to return. If not filled in, it will be set to 100, and cannot be set higher than 100. [Pagination More Info](#pagination)
 
 RecipeOutput:
     type: Object

type_spec/external/api/recipes/unarchive_recipes.yaml

@@ -0,0 +1,17 @@
+$endpoint:
+    is_sdk: true
+    method: post
+    path: ${external}/recipes/unarchive
+    function: main.site.app.external.recipes.unarchive_recipes.unarchive_recipes
+    desc: Unarchive/restore the provided recipes
+
+Arguments:
+    type: Object
+    properties:
+        recipes:
+            type: List<identifier.IdentifierKey>
+            desc: Identifier for the recipe
+
+
+Data:
+  type: Object

uncountable/core/__init__.py

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

uncountable/core/client.py

@@ -1,4 +1,5 @@
 import base64
+from datetime import datetime, timedelta
 import json
 import typing
 from dataclasses import dataclass
@@ -14,7 +15,7 @@ from pkgs.serialization_util.serialization_helpers import JsonValue
 from uncountable.types.client_base import APIRequest, ClientMethods
 
 from .file_upload import FileUpload, FileUploader, UploadedFile
-from .types import AuthDetails, AuthDetailsApiKey
+from .types import AuthDetails, AuthDetailsApiKey, AuthDetailsOAuth
 
 DT = typing.TypeVar("DT")
 
@@ -48,11 +49,13 @@ class HTTPPostRequest(HTTPRequestBase):
 HTTPRequest = HTTPPostRequest | HTTPGetRequest
 
 
-
 @dataclass(kw_only=True)
-class ClientConfig():
+class ClientConfig:
     allow_insecure_tls: bool = False
-      
+
+
+OAUTH_REFRESH_WINDOW_SECONDS = 60 * 5
+
 
 class APIResponseError(BaseException):
     status_code: int
@@ -107,19 +110,60 @@ class SDKError(BaseException):
         return f"internal SDK error, please contact Uncountable support: {self.message}"
 
 
+@dataclass(kw_only=True)
+class OAuthBearerTokenCache:
+    token: str
+    expires_at: datetime
+
+
+@dataclass(kw_only=True)
+class GetOauthBearerTokenData:
+    access_token: str
+    expires_in: int
+    token_type: str
+    scope: str
+
+
+oauth_bearer_token_data_parser = CachedParser(GetOauthBearerTokenData)
+
+
 class Client(ClientMethods):
     _parser_map: dict[type, CachedParser] = {}
     _auth_details: AuthDetails
     _base_url: str
     _file_uploader: FileUploader
     _cfg: ClientConfig
+    _oauth_bearer_token_cache: OAuthBearerTokenCache | None = None
 
-    def __init__(self, *, base_url: str, auth_details: AuthDetails, config: ClientConfig | None = None):
+    def __init__(
+        self,
+        *,
+        base_url: str,
+        auth_details: AuthDetails,
+        config: ClientConfig | None = None,
+    ):
         self._auth_details = auth_details
         self._base_url = base_url
         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]:
+        if response.status_code < 200 or response.status_code > 299:
+            extra_details: dict[str, JsonValue] | None = None
+            try:
+                data = response.json()
+                if "error" in data:
+                    extra_details = data["error"]
+            except JSONDecodeError:
+                pass
+            raise APIResponseError.construct_error(
+                status_code=response.status_code, extra_details=extra_details
+            )
+        try:
+            return response.json()
+        except JSONDecodeError:
+            raise SDKError("unable to process response")
+
     def do_request(self, *, api_request: APIRequest, return_type: type[DT]) -> DT:
         http_request = self._build_http_request(api_request=api_request)
         match http_request:
@@ -128,7 +172,7 @@ class Client(ClientMethods):
                     http_request.url,
                     headers=http_request.headers,
                     params=http_request.query_params,
-                    verify=not self._cfg.allow_insecure_tls
+                    verify=not self._cfg.allow_insecure_tls,
                 )
             case HTTPPostRequest():
                 response = requests.post(
@@ -136,26 +180,16 @@ class Client(ClientMethods):
                     headers=http_request.headers,
                     data=http_request.body,
                     params=http_request.query_params,
-                    verify=not self._cfg.allow_insecure_tls
+                    verify=not self._cfg.allow_insecure_tls,
                 )
             case _:
                 typing.assert_never(http_request)
-        if response.status_code < 200 or response.status_code > 299:
-            extra_details: dict[str, JsonValue] | None = None
-            try:
-                data = response.json()
-                if "error" in data:
-                    extra_details = data["error"]
-            except JSONDecodeError:
-                pass
-            raise APIResponseError.construct_error(
-                status_code=response.status_code, extra_details=extra_details
-            )
+        response_data = self._get_response_json(response)
         cached_parser = self._get_cached_parser(return_type)
         try:
-            data = response.json()["data"]
+            data = response_data["data"]
             return cached_parser.parse_api(data)
-        except ValueError | JSONDecodeError:
+        except ValueError | JSONDecodeError | KeyError:
             raise SDKError("unable to process response")
 
     def _get_cached_parser(self, data_type: type[DT]) -> CachedParser[DT]:
@@ -163,6 +197,32 @@ class Client(ClientMethods):
             self._parser_map[data_type] = CachedParser(data_type)
         return self._parser_map[data_type]
 
+    def _get_oauth_bearer_token(self, *, oauth_details: AuthDetailsOAuth) -> str:
+        if (
+            self._oauth_bearer_token_cache is None
+            or (
+                self._oauth_bearer_token_cache.expires_at - datetime.now()
+            ).total_seconds()
+            < OAUTH_REFRESH_WINDOW_SECONDS
+        ):
+            refresh_url = urljoin(self._base_url, "/token/get_bearer_token")
+            response = requests.post(
+                refresh_url,
+                data={
+                    "client_secret": oauth_details.refresh_token,
+                    "scope": oauth_details.scope,
+                    "grant_type": "client_credentials",
+                },
+            )
+            data = self._get_response_json(response)
+            token_data = oauth_bearer_token_data_parser.parse_storage(data)
+            self._oauth_bearer_token_cache = OAuthBearerTokenCache(
+                token=token_data.access_token,
+                expires_at=datetime.now() + timedelta(seconds=token_data.expires_in),
+            )
+
+        return self._oauth_bearer_token_cache.token
+
     def _build_auth_headers(self) -> dict[str, str]:
         match self._auth_details:
             case AuthDetailsApiKey():
@@ -170,6 +230,9 @@ class Client(ClientMethods):
                     f"{self._auth_details.api_id}:{self._auth_details.api_secret_key}".encode()
                 ).decode("utf-8")
                 return {"Authorization": f"Basic {encoded}"}
+            case AuthDetailsOAuth():
+                token = self._get_oauth_bearer_token(oauth_details=self._auth_details)
+                return {"Authorization": f"Bearer {token}"}
         typing.assert_never(self._auth_details)
 
     def _build_http_request(self, *, api_request: APIRequest) -> HTTPRequest:

uncountable/core/types.py

@@ -1,16 +1,4 @@
-import base64
-import json
-import typing
 from dataclasses import dataclass
-from enum import StrEnum
-from urllib.parse import urljoin
-
-import aiohttp
-import requests
-
-from pkgs.argument_parser import CachedParser
-from pkgs.serialization_util import serialize_for_api
-from uncountable.types.client_base import APIRequest, ClientMethods
 
 
 @dataclass(kw_only=True)
@@ -19,4 +7,10 @@ class AuthDetailsApiKey:
     api_secret_key: str
 
 
-AuthDetails = AuthDetailsApiKey
+@dataclass(kw_only=True)
+class AuthDetailsOAuth:
+    refresh_token: str
+    scope: str = "unc.rnd"
+
+
+AuthDetails = AuthDetailsApiKey | AuthDetailsOAuth

uncountable/types/__init__.py

@@ -48,6 +48,7 @@ from . import input_attributes as input_attributes_t
 from . import inputs as inputs_t
 from .api.entity import list_entities as list_entities_t
 from .api.id_source import list_id_source as list_id_source_t
+from .api.entity import lock_entity as lock_entity_t
 from .api.id_source import match_id_source as match_id_source_t
 from . import outputs as outputs_t
 from . import permissions as permissions_t
@@ -66,13 +67,19 @@ from . import response as response_t
 from .api.triggers import run_trigger as run_trigger_t
 from .api.permissions import set_core_permissions as set_core_permissions_t
 from .api.inputs import set_input_attribute_values as set_input_attribute_values_t
+from .api.inputs import set_input_category as set_input_category_t
+from .api.inputs import set_input_subcategories as set_input_subcategories_t
 from .api.recipes import set_recipe_inputs as set_recipe_inputs_t
 from .api.recipes import set_recipe_metadata as set_recipe_metadata_t
 from .api.recipes import set_recipe_outputs as set_recipe_outputs_t
 from .api.recipes import set_recipe_tags as set_recipe_tags_t
 from .api.entity import set_values as set_values_t
 from .api.entity import transition_entity_phase as transition_entity_phase_t
+from .api.recipes import unarchive_recipes as unarchive_recipes_t
 from . import units as units_t
+from .api.entity import unlock_entity as unlock_entity_t
+from .api.material_families import update_entity_material_families as update_entity_material_families_t
+from .api.field_options import upsert_field_options as upsert_field_options_t
 from . import users as users_t
 from . import workflows as workflows_t
 
@@ -123,6 +130,7 @@ __all__: list[str] = [
     "inputs_t",
     "list_entities_t",
     "list_id_source_t",
+    "lock_entity_t",
     "match_id_source_t",
     "outputs_t",
     "permissions_t",
@@ -141,13 +149,19 @@ __all__: list[str] = [
     "run_trigger_t",
     "set_core_permissions_t",
     "set_input_attribute_values_t",
+    "set_input_category_t",
+    "set_input_subcategories_t",
     "set_recipe_inputs_t",
     "set_recipe_metadata_t",
     "set_recipe_outputs_t",
     "set_recipe_tags_t",
     "set_values_t",
     "transition_entity_phase_t",
+    "unarchive_recipes_t",
     "units_t",
+    "unlock_entity_t",
+    "update_entity_material_families_t",
+    "upsert_field_options_t",
     "users_t",
     "workflows_t",
 ]

uncountable/types/api/entity/lock_entity.py

@@ -0,0 +1,38 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# flake8: noqa: F821
+# ruff: noqa: E402
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+from dataclasses import dataclass
+from ... import async_batch as async_batch_t
+from ... import entity as entity_t
+from ... import identifier as identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/entity/external_lock_entity"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Arguments:
+    entity_key: identifier_t.IdentifierKey
+    entity_type: entity_t.EntityType
+    globally_removable: typing.Optional[bool] = None
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Data(async_batch_t.AsyncBatchActionReturn):
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/entity/unlock_entity.py

@@ -0,0 +1,37 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# flake8: noqa: F821
+# ruff: noqa: E402
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+from dataclasses import dataclass
+from ... import async_batch as async_batch_t
+from ... import entity as entity_t
+from ... import identifier as identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/entity/external_unlock_entity"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Arguments:
+    entity_key: identifier_t.IdentifierKey
+    entity_type: entity_t.EntityType
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Data(async_batch_t.AsyncBatchActionReturn):
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/field_options/__init__.py

@@ -0,0 +1 @@
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/field_options/upsert_field_options.py

@@ -0,0 +1,45 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# flake8: noqa: F821
+# ruff: noqa: E402
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+from dataclasses import dataclass
+from ... import identifier as identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+    "FieldOption",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/field_options/upsert_field_options"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class FieldOption:
+    option_id: str
+    option_value: typing.Optional[str] = None
+    archived: typing.Optional[bool] = None
+    subsets: typing.Optional[list[str]] = None
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Arguments:
+    option_set_key: identifier_t.IdentifierKey
+    field_options: list[FieldOption]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Data:
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/inputs/set_input_category.py

@@ -0,0 +1,37 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# flake8: noqa: F821
+# ruff: noqa: E402
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+from dataclasses import dataclass
+from ... import identifier as identifier_t
+from ... import response as response_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/inputs/external_set_input_category"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Arguments:
+    input_key: identifier_t.IdentifierKey
+    category_id: int
+    material_family_ids: typing.Optional[list[int]] = None
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Data(response_t.Response):
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/inputs/set_input_subcategories.py

@@ -0,0 +1,38 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# flake8: noqa: F821
+# ruff: noqa: E402
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+from dataclasses import dataclass
+from ... import identifier as identifier_t
+from ... import post_base as post_base_t
+from ... import response as response_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/inputs/external_set_input_subcategories"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Arguments:
+    input_key: identifier_t.IdentifierKey
+    subcategory_ids: list[int]
+    update_type: post_base_t.UpdateType
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Data(response_t.Response):
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/material_families/__init__.py

@@ -0,0 +1 @@
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/material_families/update_entity_material_families.py

@@ -0,0 +1,41 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# flake8: noqa: F821
+# ruff: noqa: E402
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+from dataclasses import dataclass
+from ... import base as base_t
+from ... import entity as entity_t
+from ... import identifier as identifier_t
+from ... import post_base as post_base_t
+from ... import response as response_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/material_families/external_update_entity_material_families"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Arguments:
+    entity_key: identifier_t.IdentifierKey
+    entity_type: typing.Union[typing.Literal[entity_t.EntityType.RECIPE_METADATA], typing.Literal[entity_t.EntityType.INGREDIENT], typing.Literal[entity_t.EntityType.OUTPUT], typing.Literal[entity_t.EntityType.CONDITION_PARAMETER], typing.Literal[entity_t.EntityType.INGREDIENT_ATTRIBUTE]]
+    material_family_ids: list[base_t.ObjectId]
+    update_type: post_base_t.UpdateType
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Data(response_t.Response):
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/api/recipes/create_recipe.py

@@ -30,6 +30,7 @@ class Arguments:
     material_family_id: base_t.ObjectId
     workflow_id: base_t.ObjectId
     name: typing.Optional[str] = None
+    project_id: typing.Optional[base_t.ObjectId] = None
     workflow_variant_id: typing.Optional[typing.Optional[base_t.ObjectId]] = None
     recipe_metadata: typing.Optional[list[recipe_metadata_t.MetadataValue]] = None
     identifiers: typing.Optional[recipe_identifiers_t.RecipeIdentifiers] = None

uncountable/types/api/recipes/unarchive_recipes.py

@@ -0,0 +1,34 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# flake8: noqa: F821
+# ruff: noqa: E402
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+from dataclasses import dataclass
+from ... import identifier as identifier_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/recipes/unarchive"
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Arguments:
+    recipes: list[identifier_t.IdentifierKey]
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@dataclass(kw_only=True)
+class Data:
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

uncountable/types/async_batch_processor.py

@@ -38,6 +38,7 @@ class AsyncBatchProcessorBase(ABC):
         material_family_id: base_t.ObjectId,
         workflow_id: base_t.ObjectId,
         name: typing.Optional[str] = None,
+        project_id: typing.Optional[base_t.ObjectId] = None,
         workflow_variant_id: typing.Optional[typing.Optional[base_t.ObjectId]] = None,
         recipe_metadata: typing.Optional[list[recipe_metadata_t.MetadataValue]] = None,
         identifiers: typing.Optional[recipe_identifiers_t.RecipeIdentifiers] = None,
@@ -48,6 +49,7 @@ class AsyncBatchProcessorBase(ABC):
 
         :param name: The name for the recipe
         :param material_family_id: The material family for the recipe
+        :param project_id: The identifier of the project to create the recipe in
         :param workflow_id: The identifier of the workflow to create the recipe with
         :param workflow_variant_id: The identifier of the workflow variant to create the recipe with
         :param recipe_metadata: Metadata values to populate the recipe with
@@ -58,6 +60,7 @@ class AsyncBatchProcessorBase(ABC):
         args = create_recipe_t.Arguments(
             name=name,
             material_family_id=material_family_id,
+            project_id=project_id,
             workflow_id=workflow_id,
             workflow_variant_id=workflow_variant_id,
             recipe_metadata=recipe_metadata,