studyfetch-sdk 0.1.0a14__tar.gz → 0.1.0a15__tar.gz

studyfetch_sdk-0.1.0a15/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.15"
+}

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.0-alpha.15 (2025-07-21)
+
+Full Changelog: [v0.1.0-alpha.14...v0.1.0-alpha.15](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/compare/v0.1.0-alpha.14...v0.1.0-alpha.15)
+
+### Features
+
+* **api:** api update ([39f6892](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/39f6892d0d808a46611187b13724b45b792f5b4f))
+* **api:** api update ([da33c21](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/da33c213f0a6fcfaaa865a9819920d45d0297c9c))
+* **api:** api update ([5277eb0](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/commit/5277eb0b4090384f5c35f533931259c5716f7a86))
+
 ## 0.1.0-alpha.14 (2025-07-21)
 
 Full Changelog: [v0.1.0-alpha.13...v0.1.0-alpha.14](https://github.com/GoStudyFetchGo/studyfetch-sdk-python/compare/v0.1.0-alpha.13...v0.1.0-alpha.14)

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: studyfetch_sdk
-Version: 0.1.0a14
+Version: 0.1.0a15
 Summary: The official Python library for the studyfetch-sdk API
 Project-URL: Homepage, https://github.com/GoStudyFetchGo/studyfetch-sdk-python
 Project-URL: Repository, https://github.com/GoStudyFetchGo/studyfetch-sdk-python

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/api.md

@@ -20,7 +20,7 @@ Methods:
 - <code title="post /api/v1/materials/{id}/move">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">move</a>(id) -> None</code>
 - <code title="post /api/v1/materials/{id}/rename">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">rename</a>(id) -> None</code>
 - <code title="post /api/v1/materials/{id}/reprocess">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">reprocess</a>(id) -> None</code>
-- <code title="post /api/v1/materials/search">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">search</a>() -> None</code>
+- <code title="post /api/v1/materials/search">client.v1.materials.<a href="./src/studyfetch_sdk/resources/v1/materials/materials.py">search</a>(\*\*<a href="src/studyfetch_sdk/types/v1/material_search_params.py">params</a>) -> None</code>
 
 ### Upload
 
@@ -242,12 +242,18 @@ Methods:
 
 ### Component
 
+Types:
+
+```python
+from studyfetch_sdk.types.v1.upload import ComponentGetPresignedURLResponse
+```
+
 Methods:
 
-- <code title="post /api/v1/upload/component/{componentId}/complete">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">complete_upload</a>(component_id) -> None</code>
-- <code title="post /api/v1/upload/component/{componentId}/presigned-url">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">get_presigned_url</a>(component_id) -> None</code>
-- <code title="post /api/v1/upload/component/{componentId}/file">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">upload_file</a>(component_id) -> None</code>
-- <code title="post /api/v1/upload/component/{componentId}/url">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">upload_url</a>(component_id) -> None</code>
+- <code title="post /api/v1/upload/component/{componentId}/complete">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">complete_upload</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_complete_upload_params.py">params</a>) -> None</code>
+- <code title="post /api/v1/upload/component/{componentId}/presigned-url">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">get_presigned_url</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_get_presigned_url_params.py">params</a>) -> <a href="./src/studyfetch_sdk/types/v1/upload/component_get_presigned_url_response.py">ComponentGetPresignedURLResponse</a></code>
+- <code title="post /api/v1/upload/component/{componentId}/file">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">upload_file</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_upload_file_params.py">params</a>) -> None</code>
+- <code title="post /api/v1/upload/component/{componentId}/url">client.v1.upload.component.<a href="./src/studyfetch_sdk/resources/v1/upload/component.py">upload_url</a>(component_id, \*\*<a href="src/studyfetch_sdk/types/v1/upload/component_upload_url_params.py">params</a>) -> None</code>
 
 ## AssignmentGrader
 

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "studyfetch_sdk"
-version = "0.1.0-alpha.14"
+version = "0.1.0-alpha.15"
 description = "The official Python library for the studyfetch-sdk API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/src/studyfetch_sdk/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "studyfetch_sdk"
-__version__ = "0.1.0-alpha.14"  # x-release-please-version
+__version__ = "0.1.0-alpha.15"  # x-release-please-version

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/src/studyfetch_sdk/resources/v1/components.py

@@ -56,7 +56,6 @@ class ComponentsResource(SyncAPIResource):
         *,
         config: component_create_params.Config,
         name: str,
-        origin: Literal["chat", "classroom", "upload", "console", "api"],
         type: Literal[
             "chat", "flashcards", "scenarios", "practice_test", "audio_recap", "tutor_me", "explainers", "uploads"
         ],
@@ -77,8 +76,6 @@ class ComponentsResource(SyncAPIResource):
 
           name: Name of the component
 
-          origin: Origin of the component
-
           type: Type of component to create
 
           description: Component description
@@ -99,7 +96,6 @@ class ComponentsResource(SyncAPIResource):
                 {
                     "config": config,
                     "name": name,
-                    "origin": origin,
                     "type": type,
                     "description": description,
                     "metadata": metadata,
@@ -448,7 +444,6 @@ class AsyncComponentsResource(AsyncAPIResource):
         *,
         config: component_create_params.Config,
         name: str,
-        origin: Literal["chat", "classroom", "upload", "console", "api"],
         type: Literal[
             "chat", "flashcards", "scenarios", "practice_test", "audio_recap", "tutor_me", "explainers", "uploads"
         ],
@@ -469,8 +464,6 @@ class AsyncComponentsResource(AsyncAPIResource):
 
           name: Name of the component
 
-          origin: Origin of the component
-
           type: Type of component to create
 
           description: Component description
@@ -491,7 +484,6 @@ class AsyncComponentsResource(AsyncAPIResource):
                 {
                     "config": config,
                     "name": name,
-                    "origin": origin,
                     "type": type,
                     "description": description,
                     "metadata": metadata,

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/src/studyfetch_sdk/resources/v1/materials/materials.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from typing import List
+
 import httpx
 
 from .bulk import (
@@ -31,7 +33,12 @@ from .upload import (
 from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
-from ....types.v1 import material_list_params, material_create_params, material_get_download_url_params
+from ....types.v1 import (
+    material_list_params,
+    material_create_params,
+    material_search_params,
+    material_get_download_url_params,
+)
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
     to_raw_response_wrapper,
@@ -418,6 +425,10 @@ class MaterialsResource(SyncAPIResource):
     def search(
         self,
         *,
+        query: str,
+        folder_ids: List[str] | NotGiven = NOT_GIVEN,
+        material_ids: List[str] | NotGiven = NOT_GIVEN,
+        top_k: float | NotGiven = NOT_GIVEN,
         # 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,
@@ -425,9 +436,39 @@ class MaterialsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
+        """
+        Search materials using RAG
+
+        Args:
+          query: Search query
+
+          folder_ids: Optional: Limit search to materials within specific folders (includes
+              subfolders)
+
+          material_ids: Optional: Limit search to specific material IDs
+
+          top_k: Number of results to return (default: 5)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             "/api/v1/materials/search",
+            body=maybe_transform(
+                {
+                    "query": query,
+                    "folder_ids": folder_ids,
+                    "material_ids": material_ids,
+                    "top_k": top_k,
+                },
+                material_search_params.MaterialSearchParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -807,6 +848,10 @@ class AsyncMaterialsResource(AsyncAPIResource):
     async def search(
         self,
         *,
+        query: str,
+        folder_ids: List[str] | NotGiven = NOT_GIVEN,
+        material_ids: List[str] | NotGiven = NOT_GIVEN,
+        top_k: float | NotGiven = NOT_GIVEN,
         # 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,
@@ -814,9 +859,39 @@ class AsyncMaterialsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
+        """
+        Search materials using RAG
+
+        Args:
+          query: Search query
+
+          folder_ids: Optional: Limit search to materials within specific folders (includes
+              subfolders)
+
+          material_ids: Optional: Limit search to specific material IDs
+
+          top_k: Number of results to return (default: 5)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             "/api/v1/materials/search",
+            body=await async_maybe_transform(
+                {
+                    "query": query,
+                    "folder_ids": folder_ids,
+                    "material_ids": material_ids,
+                    "top_k": top_k,
+                },
+                material_search_params.MaterialSearchParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/src/studyfetch_sdk/resources/v1/upload/component.py

@@ -2,9 +2,12 @@
 
 from __future__ import annotations
 
+from typing import Mapping, cast
+
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven, FileTypes
+from ...._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -14,6 +17,13 @@ from ...._response import (
     async_to_streamed_response_wrapper,
 )
 from ...._base_client import make_request_options
+from ....types.v1.upload import (
+    component_upload_url_params,
+    component_upload_file_params,
+    component_complete_upload_params,
+    component_get_presigned_url_params,
+)
+from ....types.v1.upload.component_get_presigned_url_response import ComponentGetPresignedURLResponse
 
 __all__ = ["ComponentResource", "AsyncComponentResource"]
 
@@ -42,6 +52,9 @@ class ComponentResource(SyncAPIResource):
         self,
         component_id: str,
         *,
+        material_id: str,
+        organization_id: str,
+        s3_key: str,
         # 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,
@@ -50,7 +63,15 @@ class ComponentResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
+        Complete a file upload after using presigned URL
+
         Args:
+          material_id: The ID of the material that was uploaded
+
+          organization_id: The ID of the organization
+
+          s3_key: The S3 key of the uploaded file
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -64,6 +85,14 @@ class ComponentResource(SyncAPIResource):
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             f"/api/v1/upload/component/{component_id}/complete",
+            body=maybe_transform(
+                {
+                    "material_id": material_id,
+                    "organization_id": organization_id,
+                    "s3_key": s3_key,
+                },
+                component_complete_upload_params.ComponentCompleteUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -74,15 +103,29 @@ class ComponentResource(SyncAPIResource):
         self,
         component_id: str,
         *,
+        content_type: str,
+        filename: str,
+        folder_id: str,
+        organization_id: str,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> ComponentGetPresignedURLResponse:
         """
+        Get a presigned URL for direct file upload
+
         Args:
+          content_type: The MIME type of the file
+
+          filename: The name of the file to upload
+
+          folder_id: The ID of the folder to upload to
+
+          organization_id: The ID of the organization
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -93,19 +136,30 @@ class ComponentResource(SyncAPIResource):
         """
         if not component_id:
             raise ValueError(f"Expected a non-empty value for `component_id` but received {component_id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             f"/api/v1/upload/component/{component_id}/presigned-url",
+            body=maybe_transform(
+                {
+                    "content_type": content_type,
+                    "filename": filename,
+                    "folder_id": folder_id,
+                    "organization_id": organization_id,
+                },
+                component_get_presigned_url_params.ComponentGetPresignedURLParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=ComponentGetPresignedURLResponse,
         )
 
     def upload_file(
         self,
         component_id: str,
         *,
+        file: FileTypes,
+        folder_id: str,
+        organization_id: str,
         # 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,
@@ -114,7 +168,15 @@ class ComponentResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
+        Upload a file to a component
+
         Args:
+          file: The file to upload
+
+          folder_id: The ID of the folder to upload to
+
+          organization_id: The ID of the organization
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -126,8 +188,22 @@ class ComponentResource(SyncAPIResource):
         if not component_id:
             raise ValueError(f"Expected a non-empty value for `component_id` but received {component_id!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        body = deepcopy_minimal(
+            {
+                "file": file,
+                "folder_id": folder_id,
+                "organization_id": organization_id,
+            }
+        )
+        files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers["Content-Type"] = "multipart/form-data"
         return self._post(
             f"/api/v1/upload/component/{component_id}/file",
+            body=maybe_transform(body, component_upload_file_params.ComponentUploadFileParams),
+            files=files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -138,6 +214,10 @@ class ComponentResource(SyncAPIResource):
         self,
         component_id: str,
         *,
+        folder_id: str,
+        name: str,
+        organization_id: str,
+        url: str,
         # 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,
@@ -146,7 +226,17 @@ class ComponentResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
+        Upload a file from URL to a component
+
         Args:
+          folder_id: The ID of the folder to upload to
+
+          name: The name for the uploaded file
+
+          organization_id: The ID of the organization
+
+          url: The URL of the file to upload
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -160,6 +250,15 @@ class ComponentResource(SyncAPIResource):
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
             f"/api/v1/upload/component/{component_id}/url",
+            body=maybe_transform(
+                {
+                    "folder_id": folder_id,
+                    "name": name,
+                    "organization_id": organization_id,
+                    "url": url,
+                },
+                component_upload_url_params.ComponentUploadURLParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -191,6 +290,9 @@ class AsyncComponentResource(AsyncAPIResource):
         self,
         component_id: str,
         *,
+        material_id: str,
+        organization_id: str,
+        s3_key: str,
         # 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,
@@ -199,7 +301,15 @@ class AsyncComponentResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
+        Complete a file upload after using presigned URL
+
         Args:
+          material_id: The ID of the material that was uploaded
+
+          organization_id: The ID of the organization
+
+          s3_key: The S3 key of the uploaded file
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -213,6 +323,14 @@ class AsyncComponentResource(AsyncAPIResource):
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             f"/api/v1/upload/component/{component_id}/complete",
+            body=await async_maybe_transform(
+                {
+                    "material_id": material_id,
+                    "organization_id": organization_id,
+                    "s3_key": s3_key,
+                },
+                component_complete_upload_params.ComponentCompleteUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -223,15 +341,29 @@ class AsyncComponentResource(AsyncAPIResource):
         self,
         component_id: str,
         *,
+        content_type: str,
+        filename: str,
+        folder_id: str,
+        organization_id: str,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> None:
+    ) -> ComponentGetPresignedURLResponse:
         """
+        Get a presigned URL for direct file upload
+
         Args:
+          content_type: The MIME type of the file
+
+          filename: The name of the file to upload
+
+          folder_id: The ID of the folder to upload to
+
+          organization_id: The ID of the organization
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -242,19 +374,30 @@ class AsyncComponentResource(AsyncAPIResource):
         """
         if not component_id:
             raise ValueError(f"Expected a non-empty value for `component_id` but received {component_id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             f"/api/v1/upload/component/{component_id}/presigned-url",
+            body=await async_maybe_transform(
+                {
+                    "content_type": content_type,
+                    "filename": filename,
+                    "folder_id": folder_id,
+                    "organization_id": organization_id,
+                },
+                component_get_presigned_url_params.ComponentGetPresignedURLParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=NoneType,
+            cast_to=ComponentGetPresignedURLResponse,
         )
 
     async def upload_file(
         self,
         component_id: str,
         *,
+        file: FileTypes,
+        folder_id: str,
+        organization_id: str,
         # 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,
@@ -263,7 +406,15 @@ class AsyncComponentResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
+        Upload a file to a component
+
         Args:
+          file: The file to upload
+
+          folder_id: The ID of the folder to upload to
+
+          organization_id: The ID of the organization
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -275,8 +426,22 @@ class AsyncComponentResource(AsyncAPIResource):
         if not component_id:
             raise ValueError(f"Expected a non-empty value for `component_id` but received {component_id!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        body = deepcopy_minimal(
+            {
+                "file": file,
+                "folder_id": folder_id,
+                "organization_id": organization_id,
+            }
+        )
+        files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers["Content-Type"] = "multipart/form-data"
         return await self._post(
             f"/api/v1/upload/component/{component_id}/file",
+            body=await async_maybe_transform(body, component_upload_file_params.ComponentUploadFileParams),
+            files=files,
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -287,6 +452,10 @@ class AsyncComponentResource(AsyncAPIResource):
         self,
         component_id: str,
         *,
+        folder_id: str,
+        name: str,
+        organization_id: str,
+        url: str,
         # 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,
@@ -295,7 +464,17 @@ class AsyncComponentResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
         """
+        Upload a file from URL to a component
+
         Args:
+          folder_id: The ID of the folder to upload to
+
+          name: The name for the uploaded file
+
+          organization_id: The ID of the organization
+
+          url: The URL of the file to upload
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -309,6 +488,15 @@ class AsyncComponentResource(AsyncAPIResource):
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
             f"/api/v1/upload/component/{component_id}/url",
+            body=await async_maybe_transform(
+                {
+                    "folder_id": folder_id,
+                    "name": name,
+                    "organization_id": organization_id,
+                    "url": url,
+                },
+                component_upload_url_params.ComponentUploadURLParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/src/studyfetch_sdk/types/v1/__init__.py

@@ -18,6 +18,7 @@ from .flashcard_rate_params import FlashcardRateParams as FlashcardRateParams
 from .embed_get_theme_params import EmbedGetThemeParams as EmbedGetThemeParams
 from .material_create_params import MaterialCreateParams as MaterialCreateParams
 from .material_list_response import MaterialListResponse as MaterialListResponse
+from .material_search_params import MaterialSearchParams as MaterialSearchParams
 from .scenario_create_params import ScenarioCreateParams as ScenarioCreateParams
 from .scenario_update_params import ScenarioUpdateParams as ScenarioUpdateParams
 from .usage_get_stats_params import UsageGetStatsParams as UsageGetStatsParams

{studyfetch_sdk-0.1.0a14 → studyfetch_sdk-0.1.0a15}/src/studyfetch_sdk/types/v1/component_create_params.py

@@ -31,9 +31,6 @@ class ComponentCreateParams(TypedDict, total=False):
     name: Required[str]
     """Name of the component"""
 
-    origin: Required[Literal["chat", "classroom", "upload", "console", "api"]]
-    """Origin of the component"""
-
     type: Required[
         Literal["chat", "flashcards", "scenarios", "practice_test", "audio_recap", "tutor_me", "explainers", "uploads"]
     ]