UncountablePythonSDK 0.0.25__tar.gz → 0.0.26__tar.gz

{uncountablepythonsdk-0.0.25/UncountablePythonSDK.egg-info → uncountablepythonsdk-0.0.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.25
+Version: 0.0.26
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26/UncountablePythonSDK.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: UncountablePythonSDK
-Version: 0.0.25
+Version: 0.0.26
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/UncountablePythonSDK.egg-info/SOURCES.txt

@@ -76,9 +76,12 @@ type_spec/external/api/entity/create_entities.yaml
 type_spec/external/api/entity/create_entity.yaml
 type_spec/external/api/entity/get_entities_data.yaml
 type_spec/external/api/entity/list_entities.yaml
+type_spec/external/api/entity/lock_entity.yaml
 type_spec/external/api/entity/resolve_entity_ids.yaml
 type_spec/external/api/entity/set_values.yaml
 type_spec/external/api/entity/transition_entity_phase.yaml
+type_spec/external/api/entity/unlock_entity.yaml
+type_spec/external/api/field_options/upsert_field_options.yaml
 type_spec/external/api/id_source/list_id_source.yaml
 type_spec/external/api/id_source/match_id_source.yaml
 type_spec/external/api/input_groups/get_input_group_names.yaml
@@ -87,6 +90,9 @@ type_spec/external/api/inputs/get_input_data.yaml
 type_spec/external/api/inputs/get_input_names.yaml
 type_spec/external/api/inputs/get_inputs_data.yaml
 type_spec/external/api/inputs/set_input_attribute_values.yaml
+type_spec/external/api/inputs/set_input_category.yaml
+type_spec/external/api/inputs/set_input_subcategories.yaml
+type_spec/external/api/material_families/update_entity_material_families.yaml
 type_spec/external/api/outputs/get_output_data.yaml
 type_spec/external/api/outputs/get_output_names.yaml
 type_spec/external/api/outputs/resolve_output_conditions.yaml
@@ -112,6 +118,7 @@ type_spec/external/api/recipes/set_recipe_inputs.yaml
 type_spec/external/api/recipes/set_recipe_metadata.yaml
 type_spec/external/api/recipes/set_recipe_outputs.yaml
 type_spec/external/api/recipes/set_recipe_tags.yaml
+type_spec/external/api/recipes/unarchive_recipes.yaml
 type_spec/external/api/triggers/run_trigger.yaml
 uncountable/__init__.py
 uncountable/py.typed
@@ -173,9 +180,13 @@ uncountable/types/api/entity/create_entities.py
 uncountable/types/api/entity/create_entity.py
 uncountable/types/api/entity/get_entities_data.py
 uncountable/types/api/entity/list_entities.py
+uncountable/types/api/entity/lock_entity.py
 uncountable/types/api/entity/resolve_entity_ids.py
 uncountable/types/api/entity/set_values.py
 uncountable/types/api/entity/transition_entity_phase.py
+uncountable/types/api/entity/unlock_entity.py
+uncountable/types/api/field_options/__init__.py
+uncountable/types/api/field_options/upsert_field_options.py
 uncountable/types/api/id_source/__init__.py
 uncountable/types/api/id_source/list_id_source.py
 uncountable/types/api/id_source/match_id_source.py
@@ -187,6 +198,10 @@ uncountable/types/api/inputs/get_input_data.py
 uncountable/types/api/inputs/get_input_names.py
 uncountable/types/api/inputs/get_inputs_data.py
 uncountable/types/api/inputs/set_input_attribute_values.py
+uncountable/types/api/inputs/set_input_category.py
+uncountable/types/api/inputs/set_input_subcategories.py
+uncountable/types/api/material_families/__init__.py
+uncountable/types/api/material_families/update_entity_material_families.py
 uncountable/types/api/outputs/__init__.py
 uncountable/types/api/outputs/get_output_data.py
 uncountable/types/api/outputs/get_output_names.py
@@ -218,5 +233,6 @@ uncountable/types/api/recipes/set_recipe_inputs.py
 uncountable/types/api/recipes/set_recipe_metadata.py
 uncountable/types/api/recipes/set_recipe_outputs.py
 uncountable/types/api/recipes/set_recipe_tags.py
+uncountable/types/api/recipes/unarchive_recipes.py
 uncountable/types/api/triggers/__init__.py
 uncountable/types/api/triggers/run_trigger.py

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/examples/create_entity.py

@@ -1,5 +1,4 @@
-from uncountable.core import Client
-from uncountable.core.client import AuthDetailsOAuth
+from uncountable.core import AuthDetailsOAuth, Client
 from uncountable.types import (
     entity_t,
     field_values_t,

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/pkgs/argument_parser/argument_parser.py

@@ -24,6 +24,7 @@ ParserCache = dict[type[typing.Any], ParserFunction[typing.Any]]
 @dataclass(frozen=True, eq=True)
 class ParserOptions:
     convert_to_snake_case: bool
+    strict_property_parsing: bool = False
 
 
 @dataclass(frozen=True)
@@ -32,6 +33,19 @@ class ParserContext:
     cache: ParserCache
 
 
+class ParserError(BaseException): ...
+
+
+class ParserExtraFieldsError(ParserError):
+    extra_fields: set[str]
+
+    def __init__(self, extra_fields: set[str]) -> None:
+        self.extra_fields = extra_fields
+
+    def __str__(self) -> str:
+        return f"extra fields were provided: {', '.join(self.extra_fields)}"
+
+
 def is_optional(field_type: typing.Any) -> bool:
     return typing.get_origin(field_type) is typing.Union and type(
         None
@@ -280,18 +294,23 @@ def _build_parser_dataclass(
 
     serial_class_data = get_serial_class_data(parsed_type)
 
+    def resolve_serialized_field_name(*, field_name: str) -> str:
+        return (
+            snake_to_camel_case(field_name)
+            if (
+                context.options.convert_to_snake_case
+                and not serial_class_data.has_unconverted_key(field_name)
+            )
+            else field_name
+        )
+
     def parse(value: typing.Any) -> typing.Any:
         data: dict[typing.Any, typing.Any] = {}
         for field, field_type, field_parser in dc_field_parsers:
             field_raw_value = None
             try:
                 field_raw_value = value.get(
-                    snake_to_camel_case(field.name)
-                    if (
-                        context.options.convert_to_snake_case
-                        and not serial_class_data.has_unconverted_key(field.name)
-                    )
-                    else field.name,
+                    resolve_serialized_field_name(field_name=field.name),
                     MISSING,
                 )
                 field_value: typing.Any
@@ -325,6 +344,18 @@ def _build_parser_dataclass(
                     f"unable to parse field:{field.name}", field_raw_value
                 ) from e
 
+        if context.options.strict_property_parsing:
+            all_allowed_field_names = set(
+                resolve_serialized_field_name(field_name=field.name)
+                for (field, _, _) in dc_field_parsers
+            )
+            passed_field_names = set(value.keys())
+            disallowed_field_names = passed_field_names.difference(
+                all_allowed_field_names
+            )
+            if len(disallowed_field_names) > 0:
+                raise ParserExtraFieldsError(disallowed_field_names)
+
         return parsed_type(**data)
 
     # Add to cache before building inner types, to support recursion
@@ -372,10 +403,12 @@ class CachedParser(typing.Generic[T]):
     def __init__(
         self,
         args: type[T],
+        strict_property_parsing: bool = False,
     ):
         self.arguments = args
         self.parser_api: typing.Optional[ParserFunction[T]] = None
         self.parser_storage: typing.Optional[ParserFunction[T]] = None
+        self.strict_property_parsing = strict_property_parsing
 
     def parse_api(self, args: typing.Any) -> T:
         """
@@ -390,6 +423,7 @@ class CachedParser(typing.Generic[T]):
                 self.arguments,
                 ParserOptions(
                     convert_to_snake_case=True,
+                    strict_property_parsing=self.strict_property_parsing,
                 ),
             )
         assert self.parser_api is not None
@@ -404,6 +438,7 @@ class CachedParser(typing.Generic[T]):
                 self.arguments,
                 ParserOptions(
                     convert_to_snake_case=False,
+                    strict_property_parsing=self.strict_property_parsing,
                 ),
             )
         assert self.parser_storage is not None

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/pkgs/type_spec/builder.py

@@ -195,6 +195,7 @@ class SpecEndpointExample:
 
 @dataclass(kw_only=True)
 class SpecGuide:
+    ref_name: str
     title: str
     markdown_content: str
     html_content: str
@@ -1287,7 +1288,10 @@ class SpecBuilder:
         meta: dict[str, list[str]] = md.Meta  # type: ignore[attr-defined]
         title_meta: list[str] | None = meta.get("title")
         if title_meta is None:
-            raise Exception("guides requier a title in the meta section")
+            raise Exception("guides require a title in the meta section")
+        id_meta: list[str] | None = meta.get("id")
+        if id_meta is None:
+            raise Exception("guides require an id in the meta section")
 
         path_meta: list[str] | None = meta.get("path")
         guide_key: SpecGuideKey = RootGuideKey()
@@ -1297,6 +1301,7 @@ class SpecBuilder:
 
         self.guides[guide_key].append(
             SpecGuide(
+                ref_name="".join(id_meta),
                 title="".join(title_meta),
                 html_content=html,
                 markdown_content=file_content,

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/pkgs/type_spec/emit_open_api.py

@@ -78,9 +78,9 @@ def _rewrite_with_notice(
     return util.rewrite_file(file_path, f"{notice}\n{modified_file_content}")
 
 
-def _write_guide_as_html(guide: EmitOpenAPIGuide) -> str:
+def _write_guide_as_html(guide: EmitOpenAPIGuide, *, is_open: bool) -> str:
     return f"""
-        <details>
+        <details id="{guide.ref_name}" {"open" if is_open else ""}>
         <summary>{guide.title}</summary>
         {guide.html_content}
         </details>"""
@@ -89,7 +89,10 @@ def _write_guide_as_html(guide: EmitOpenAPIGuide) -> str:
 def _open_api_info(
     config: OpenAPIConfig, guides: list[EmitOpenAPIGuide]
 ) -> GlobalContextInfo:
-    full_guides = "<br/>".join([_write_guide_as_html(guide) for guide in guides])
+    full_guides = "<br/>".join([
+        _write_guide_as_html(guide, is_open=True)
+        for guide in sorted(guides, key=lambda g: g.ref_name)
+    ])
     full_description = f"{config.description}<br/>{full_guides}"
     info: GlobalContextInfo = dict()
     info["version"] = "1.0.0"
@@ -107,7 +110,9 @@ def _open_api_servers(config: OpenAPIConfig) -> list[EmitOpenAPIServer]:
 def emit_open_api(builder: builder.SpecBuilder, *, config: OpenAPIConfig) -> None:
     root_guides = builder.guides.get(RootGuideKey(), [])
     openapi_guides = [
-        EmitOpenAPIGuide(title=guide.title, html_content=guide.html_content)
+        EmitOpenAPIGuide(
+            ref_name=guide.ref_name, title=guide.title, html_content=guide.html_content
+        )
         for guide in root_guides
     ]
     gctx = EmitOpenAPIGlobalContext(
@@ -299,7 +304,10 @@ def _emit_endpoint_response_examples(
 def _emit_endpoint_description(
     description: str, guides: list[EmitOpenAPIGuide]
 ) -> dict[str, str]:
-    full_guides = "<br/>".join([_write_guide_as_html(guide) for guide in guides])
+    full_guides = "<br/>".join([
+        _write_guide_as_html(guide, is_open=False)
+        for guide in sorted(guides, key=lambda g: g.ref_name)
+    ])
     return {
         "description": description
         if len(guides) == 0
@@ -562,6 +570,7 @@ def _emit_endpoint(
         ],
         guides=[
             EmitOpenAPIGuide(
+                ref_name=guide.ref_name,
                 title=guide.title,
                 html_content=guide.html_content,
             )

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/pkgs/type_spec/emit_open_api_util.py

@@ -45,6 +45,7 @@ class EmitOpenAPIServer:
 
 @dataclass(kw_only=True)
 class EmitOpenAPIGuide:
+    ref_name: str
     title: str
     html_content: str
 

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/type_spec/external/api/entity/list_entities.yaml

@@ -18,10 +18,10 @@ Arguments:
             desc: "Attributes to pass to the configuration for parameterizing filters"
         offset?:
             type: Optional<Integer>
-            desc: "Used for pagination. Pagination is done based on the sorting of the config"
+            desc: Used for pagination. Pagination is done based on the sorting of the config. [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)
 
 EntityResult:
     type: Object

uncountablepythonsdk-0.0.26/type_spec/external/api/entity/lock_entity.yaml

@@ -0,0 +1,21 @@
+$endpoint:
+    is_sdk: true
+    method: post
+    path: ${external}/entity/external_lock_entity
+    function: main.site.app.external.entity.external_lock_entity.external_lock_entity
+    desc: Lock an entity
+
+Arguments:
+    type: Object
+    properties:
+        entity_key:
+            type: identifier.IdentifierKey
+            desc: "Identifier for the entity"
+        entity_type:
+            type: entity.EntityType
+        globally_removable?:
+            type: Boolean
+            desc: "Should the lock be removable by any user or just admins"
+
+Data:
+  type: async_batch.AsyncBatchActionReturn

uncountablepythonsdk-0.0.26/type_spec/external/api/entity/unlock_entity.yaml

@@ -0,0 +1,18 @@
+$endpoint:
+    is_sdk: true
+    method: post
+    path: ${external}/entity/external_unlock_entity
+    function: main.site.app.external.entity.external_unlock_entity.external_unlock_entity
+    desc: Unlock an entity
+
+Arguments:
+    type: Object
+    properties:
+        entity_key:
+            type: identifier.IdentifierKey
+            desc: "Identifier for the entity"
+        entity_type:
+            type: entity.EntityType
+
+Data:
+  type: async_batch.AsyncBatchActionReturn

uncountablepythonsdk-0.0.26/type_spec/external/api/field_options/upsert_field_options.yaml

@@ -0,0 +1,37 @@
+$endpoint:
+    is_sdk: true
+    method: post
+    path: ${external}/field_options/upsert_field_options
+    function: main.site.app.external.field_options.upsert_field_options.upsert_field_options
+    desc: "Creates or updates field options for an option set"
+    is_sdk: true
+
+FieldOption:
+    type: Object
+    properties:
+        option_id:
+            type: String
+            desc: "A unique identifer for the option.  This is required to be a string with no symbols"
+        option_value?:
+            type: String
+            desc: "The label for the option.  If none is set, then the existing value will be used.  If there is no existing value, then the option id will be used."
+        archived?:
+            type: Boolean
+            desc: "If included, whether to set the option to be archived or unarchived"
+        subsets?:
+            type: List<String>
+            desc: "If included, what subsets to include the option in"
+
+Arguments:
+    type: Object
+    properties:
+        option_set_key:
+            type: identifier.IdentifierKey
+            desc: "Identifier for the field option set"
+        field_options:
+            type: List<FieldOption>
+            desc: Field options to upsert
+
+Data:
+    type: Object
+    properties:

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/type_spec/external/api/id_source/list_id_source.yaml

@@ -15,10 +15,10 @@ Arguments:
             desc: Text to search within the labels to search matches
         offset?:
             type: Optional<Integer>
-            desc: "Used for pagination. Pagination is done based on the sorting of the config"
+            desc: Used for pagination. Pagination is done based on the sorting of the config. [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)
 
 IdName:
     type: Object

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/type_spec/external/api/inputs/get_input_data.yaml

@@ -16,13 +16,13 @@ Arguments:
             desc: "The input IDs to get the data from. If this is not filled in, all inputs 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 input ID"
+            desc: Used for pagination, where the number of results returned exceeds the limit. Results are always ordered by the input ID. [Pagination More Info](#pagination)
         is_parameter:
             type: Optional<Boolean>
             desc: "Whether to get parameters or ingredients. By default both are returned. When set to true, only parameters are returned, and when set to false, only ingredients are returned"
         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)
 
 SimpleInputAttr:
     type: Object

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/type_spec/external/api/inputs/get_input_names.yaml

@@ -13,13 +13,13 @@ Arguments:
             desc: "The material family ID to get the input values from"
         offset?:
             type: Optional<Integer>
-            desc: "Used for pagination, where the number of results returned exceeds the limit. Results are always ordered by the input ID"
+            desc: Used for pagination, where the number of results returned exceeds the limit. Results are always ordered by the input ID. [Pagination More Info](#pagination)
         is_parameter:
             type: Optional<Boolean>
             desc: "Whether to get parameters or ingredients. By default both are returned. When set to true, only parameters are returned, and when set to false, only ingredients are returned"
         limit?:
             type: Optional<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)
 
 InputWithName:
     type: Object

uncountablepythonsdk-0.0.26/type_spec/external/api/inputs/set_input_category.yaml

@@ -0,0 +1,23 @@
+$endpoint:
+    is_sdk: true
+    method: post
+    path: ${external}/inputs/external_set_input_category
+    function: main.site.app.external.inputs.external_set_input_category.external_set_input_category
+    desc: "Sets subcategories for an input"
+
+Arguments:
+    type: Object
+    properties:
+        input_key:
+            type: identifier.IdentifierKey
+            desc: "Identifier for the input"
+        category_id:
+            type: Integer
+            desc: The subcategory identifiers to set
+        material_family_ids?:
+            type: List<Integer>
+            desc: The material families to perform the update in
+
+Data:
+    type: response.Response
+    properties:

uncountablepythonsdk-0.0.26/type_spec/external/api/inputs/set_input_subcategories.yaml

@@ -0,0 +1,23 @@
+$endpoint:
+    is_sdk: true
+    method: post
+    path: ${external}/inputs/external_set_input_subcategories
+    function: main.site.app.external.inputs.external_set_input_subcategories.external_set_input_subcategories
+    desc: "Sets subcategories for an input"
+
+Arguments:
+    type: Object
+    properties:
+        input_key:
+            type: identifier.IdentifierKey
+            desc: "Identifier for the input"
+        subcategory_ids:
+            type: List<Integer>
+            desc: The subcategory identifiers to set
+        update_type:
+            type: post_base.UpdateType
+            desc: The type of update to perform
+
+Data:
+    type: response.Response
+    properties:

uncountablepythonsdk-0.0.26/type_spec/external/api/material_families/update_entity_material_families.yaml

@@ -0,0 +1,33 @@
+$endpoint:
+    is_sdk: true
+    method: post
+    path: ${external}/material_families/external_update_entity_material_families
+    function: main.site.app.external.material_families.update_entity_material_families.update_entity_material_families
+    desc: "Updates the material families that the entity is available in"
+
+Arguments:
+    type: Object
+    properties:
+        entity_key:
+          type: identifier.IdentifierKey
+          desc: "The identifier for the entity to update across material families"
+        entity_type:
+            type: |
+                Union<
+                    Literal<entity.EntityType.recipe_metadata>,
+                    Literal<entity.EntityType.ingredient>,
+                    Literal<entity.EntityType.output>,
+                    Literal<entity.EntityType.condition_parameter>,
+                    Literal<entity.EntityType.ingredient_attribute>
+                >
+            desc: "The type of the entities requested"
+        material_family_ids:
+            type: List<ObjectId>
+            desc: "The material families to update"
+        update_type:
+            type: post_base.UpdateType
+            desc: "The type of update to make"
+
+Data:
+    type: response.Response
+    properties:

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/type_spec/external/api/outputs/get_output_data.yaml

@@ -16,10 +16,10 @@ Arguments:
             desc: "The output IDs to get the data from. If this is not filled in, all outputs from a material family will be returned (in paginated form)."
         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 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)
 
 OutputAttrVal:
     type: Object

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/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

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/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

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/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

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/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

{uncountablepythonsdk-0.0.25 → uncountablepythonsdk-0.0.26}/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

uncountablepythonsdk-0.0.26/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