supermemory 3.0.0a1__py3-none-any.whl → 3.0.0a19__py3-none-any.whl

supermemory/resources/memories.py

@@ -3,12 +3,11 @@
 from __future__ import annotations
 
 from typing import Dict, List, Union, Mapping, cast
-from typing_extensions import Literal
 
 import httpx
 
-from ..types import memory_add_params, memory_list_params, memory_update_params, memory_upload_file_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven, FileTypes
+from ..types import memory_add_params, memory_update_params, memory_upload_file_params
+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
@@ -21,8 +20,6 @@ from .._response import (
 from .._base_client import make_request_options
 from ..types.memory_add_response import MemoryAddResponse
 from ..types.memory_get_response import MemoryGetResponse
-from ..types.memory_list_response import MemoryListResponse
-from ..types.memory_delete_response import MemoryDeleteResponse
 from ..types.memory_update_response import MemoryUpdateResponse
 from ..types.memory_upload_file_response import MemoryUploadFileResponse
 
@@ -55,6 +52,7 @@ class MemoriesResource(SyncAPIResource):
         *,
         content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | 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.
@@ -67,6 +65,27 @@ class MemoriesResource(SyncAPIResource):
         Update a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          content: The content to extract and process into a memory. This can be a URL to a
+              website, a PDF, an image, or a video.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              We automatically detect the content type from the url's response format.
+
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
+          custom_id: Optional custom ID of the memory. This could be an ID from your database that
+              will uniquely identify this memory.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -83,6 +102,7 @@ class MemoriesResource(SyncAPIResource):
                 {
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_update_params.MemoryUpdateParams,
@@ -93,64 +113,6 @@ class MemoriesResource(SyncAPIResource):
             cast_to=MemoryUpdateResponse,
         )
 
-    def list(
-        self,
-        *,
-        filters: str | NotGiven = NOT_GIVEN,
-        limit: str | NotGiven = NOT_GIVEN,
-        order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
-        page: str | NotGiven = NOT_GIVEN,
-        sort: Literal["createdAt", "updatedAt"] | 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,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> MemoryListResponse:
-        """
-        Retrieves a paginated list of memories with their metadata and workflow status
-
-        Args:
-          filters: Optional filters to apply to the search
-
-          limit: Number of items per page
-
-          order: Sort order
-
-          page: Page number to fetch
-
-          sort: Field to sort by
-
-          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
-        """
-        return self._get(
-            "/v3/memories",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform(
-                    {
-                        "filters": filters,
-                        "limit": limit,
-                        "order": order,
-                        "page": page,
-                        "sort": sort,
-                    },
-                    memory_list_params.MemoryListParams,
-                ),
-            ),
-            cast_to=MemoryListResponse,
-        )
-
     def delete(
         self,
         id: str,
@@ -161,7 +123,7 @@ class MemoriesResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> MemoryDeleteResponse:
+    ) -> None:
         """
         Delete a memory
 
@@ -176,12 +138,13 @@ class MemoriesResource(SyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._delete(
             f"/v3/memories/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryDeleteResponse,
+            cast_to=NoneType,
         )
 
     def add(
@@ -189,6 +152,7 @@ class MemoriesResource(SyncAPIResource):
         *,
         content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | 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.
@@ -201,6 +165,27 @@ class MemoriesResource(SyncAPIResource):
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          content: The content to extract and process into a memory. This can be a URL to a
+              website, a PDF, an image, or a video.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              We automatically detect the content type from the url's response format.
+
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
+          custom_id: Optional custom ID of the memory. This could be an ID from your database that
+              will uniquely identify this memory.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -215,6 +200,7 @@ class MemoriesResource(SyncAPIResource):
                 {
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_add_params.MemoryAddParams,
@@ -324,6 +310,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
         *,
         content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | 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.
@@ -336,6 +323,27 @@ class AsyncMemoriesResource(AsyncAPIResource):
         Update a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          content: The content to extract and process into a memory. This can be a URL to a
+              website, a PDF, an image, or a video.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              We automatically detect the content type from the url's response format.
+
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
+          custom_id: Optional custom ID of the memory. This could be an ID from your database that
+              will uniquely identify this memory.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -352,6 +360,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
                 {
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_update_params.MemoryUpdateParams,
@@ -362,64 +371,6 @@ class AsyncMemoriesResource(AsyncAPIResource):
             cast_to=MemoryUpdateResponse,
         )
 
-    async def list(
-        self,
-        *,
-        filters: str | NotGiven = NOT_GIVEN,
-        limit: str | NotGiven = NOT_GIVEN,
-        order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
-        page: str | NotGiven = NOT_GIVEN,
-        sort: Literal["createdAt", "updatedAt"] | 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,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> MemoryListResponse:
-        """
-        Retrieves a paginated list of memories with their metadata and workflow status
-
-        Args:
-          filters: Optional filters to apply to the search
-
-          limit: Number of items per page
-
-          order: Sort order
-
-          page: Page number to fetch
-
-          sort: Field to sort by
-
-          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
-        """
-        return await self._get(
-            "/v3/memories",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {
-                        "filters": filters,
-                        "limit": limit,
-                        "order": order,
-                        "page": page,
-                        "sort": sort,
-                    },
-                    memory_list_params.MemoryListParams,
-                ),
-            ),
-            cast_to=MemoryListResponse,
-        )
-
     async def delete(
         self,
         id: str,
@@ -430,7 +381,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> MemoryDeleteResponse:
+    ) -> None:
         """
         Delete a memory
 
@@ -445,12 +396,13 @@ class AsyncMemoriesResource(AsyncAPIResource):
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._delete(
             f"/v3/memories/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MemoryDeleteResponse,
+            cast_to=NoneType,
         )
 
     async def add(
@@ -458,6 +410,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
         *,
         content: str,
         container_tags: List[str] | NotGiven = NOT_GIVEN,
+        custom_id: str | NotGiven = NOT_GIVEN,
         metadata: Dict[str, Union[str, float, bool]] | 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.
@@ -470,6 +423,27 @@ class AsyncMemoriesResource(AsyncAPIResource):
         Add a memory with any content type (text, url, file, etc.) and metadata
 
         Args:
+          content: The content to extract and process into a memory. This can be a URL to a
+              website, a PDF, an image, or a video.
+
+              Plaintext: Any plaintext format
+
+              URL: A URL to a website, PDF, image, or video
+
+              We automatically detect the content type from the url's response format.
+
+          container_tags: Optional tags this memory should be containerized by. This can be an ID for your
+              user, a project ID, or any other identifier you wish to use to group memories.
+
+          custom_id: Optional custom ID of the memory. This could be an ID from your database that
+              will uniquely identify this memory.
+
+          metadata: Optional metadata for the memory. This is used to store additional information
+              about the memory. You can use this to store any additional information you need
+              about the memory. Metadata can be filtered through. Keys must be strings and are
+              case sensitive. Values can be strings, numbers, or booleans. You cannot nest
+              objects.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -484,6 +458,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
                 {
                     "content": content,
                     "container_tags": container_tags,
+                    "custom_id": custom_id,
                     "metadata": metadata,
                 },
                 memory_add_params.MemoryAddParams,
@@ -574,9 +549,6 @@ class MemoriesResourceWithRawResponse:
         self.update = to_raw_response_wrapper(
             memories.update,
         )
-        self.list = to_raw_response_wrapper(
-            memories.list,
-        )
         self.delete = to_raw_response_wrapper(
             memories.delete,
         )
@@ -598,9 +570,6 @@ class AsyncMemoriesResourceWithRawResponse:
         self.update = async_to_raw_response_wrapper(
             memories.update,
         )
-        self.list = async_to_raw_response_wrapper(
-            memories.list,
-        )
         self.delete = async_to_raw_response_wrapper(
             memories.delete,
         )
@@ -622,9 +591,6 @@ class MemoriesResourceWithStreamingResponse:
         self.update = to_streamed_response_wrapper(
             memories.update,
         )
-        self.list = to_streamed_response_wrapper(
-            memories.list,
-        )
         self.delete = to_streamed_response_wrapper(
             memories.delete,
         )
@@ -646,9 +612,6 @@ class AsyncMemoriesResourceWithStreamingResponse:
         self.update = async_to_streamed_response_wrapper(
             memories.update,
         )
-        self.list = async_to_streamed_response_wrapper(
-            memories.list,
-        )
         self.delete = async_to_streamed_response_wrapper(
             memories.delete,
         )

supermemory/resources/settings.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, List
+from typing import Dict, Union, Iterable, Optional
 
 import httpx
 
@@ -47,11 +47,20 @@ class SettingsResource(SyncAPIResource):
     def update(
         self,
         *,
-        exclude_items: List[str] | NotGiven = NOT_GIVEN,
-        filter_prompt: str | NotGiven = NOT_GIVEN,
-        filter_tags: Dict[str, List[str]] | NotGiven = NOT_GIVEN,
-        include_items: List[str] | NotGiven = NOT_GIVEN,
-        should_llm_filter: bool | NotGiven = NOT_GIVEN,
+        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
+        filter_prompt: Optional[str] | NotGiven = NOT_GIVEN,
+        filter_tags: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
+        google_drive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
+        google_drive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
+        google_drive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
+        include_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
+        notion_client_id: Optional[str] | NotGiven = NOT_GIVEN,
+        notion_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
+        notion_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
+        onedrive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
+        onedrive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
+        onedrive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
+        should_llm_filter: Optional[bool] | 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,
@@ -78,7 +87,16 @@ class SettingsResource(SyncAPIResource):
                     "exclude_items": exclude_items,
                     "filter_prompt": filter_prompt,
                     "filter_tags": filter_tags,
+                    "google_drive_client_id": google_drive_client_id,
+                    "google_drive_client_secret": google_drive_client_secret,
+                    "google_drive_custom_key_enabled": google_drive_custom_key_enabled,
                     "include_items": include_items,
+                    "notion_client_id": notion_client_id,
+                    "notion_client_secret": notion_client_secret,
+                    "notion_custom_key_enabled": notion_custom_key_enabled,
+                    "onedrive_client_id": onedrive_client_id,
+                    "onedrive_client_secret": onedrive_client_secret,
+                    "onedrive_custom_key_enabled": onedrive_custom_key_enabled,
                     "should_llm_filter": should_llm_filter,
                 },
                 setting_update_params.SettingUpdateParams,
@@ -132,11 +150,20 @@ class AsyncSettingsResource(AsyncAPIResource):
     async def update(
         self,
         *,
-        exclude_items: List[str] | NotGiven = NOT_GIVEN,
-        filter_prompt: str | NotGiven = NOT_GIVEN,
-        filter_tags: Dict[str, List[str]] | NotGiven = NOT_GIVEN,
-        include_items: List[str] | NotGiven = NOT_GIVEN,
-        should_llm_filter: bool | NotGiven = NOT_GIVEN,
+        exclude_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
+        filter_prompt: Optional[str] | NotGiven = NOT_GIVEN,
+        filter_tags: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
+        google_drive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
+        google_drive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
+        google_drive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
+        include_items: Union[str, float, bool, Dict[str, object], Iterable[object], None] | NotGiven = NOT_GIVEN,
+        notion_client_id: Optional[str] | NotGiven = NOT_GIVEN,
+        notion_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
+        notion_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
+        onedrive_client_id: Optional[str] | NotGiven = NOT_GIVEN,
+        onedrive_client_secret: Optional[str] | NotGiven = NOT_GIVEN,
+        onedrive_custom_key_enabled: Optional[bool] | NotGiven = NOT_GIVEN,
+        should_llm_filter: Optional[bool] | 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,
@@ -163,7 +190,16 @@ class AsyncSettingsResource(AsyncAPIResource):
                     "exclude_items": exclude_items,
                     "filter_prompt": filter_prompt,
                     "filter_tags": filter_tags,
+                    "google_drive_client_id": google_drive_client_id,
+                    "google_drive_client_secret": google_drive_client_secret,
+                    "google_drive_custom_key_enabled": google_drive_custom_key_enabled,
                     "include_items": include_items,
+                    "notion_client_id": notion_client_id,
+                    "notion_client_secret": notion_client_secret,
+                    "notion_custom_key_enabled": notion_custom_key_enabled,
+                    "onedrive_client_id": onedrive_client_id,
+                    "onedrive_client_secret": onedrive_client_secret,
+                    "onedrive_custom_key_enabled": onedrive_custom_key_enabled,
                     "should_llm_filter": should_llm_filter,
                 },
                 setting_update_params.SettingUpdateParams,

supermemory/types/__init__.py

@@ -3,22 +3,15 @@
 from __future__ import annotations
 
 from .memory_add_params import MemoryAddParams as MemoryAddParams
-from .memory_list_params import MemoryListParams as MemoryListParams
 from .memory_add_response import MemoryAddResponse as MemoryAddResponse
 from .memory_get_response import MemoryGetResponse as MemoryGetResponse
-from .memory_list_response import MemoryListResponse as MemoryListResponse
 from .memory_update_params import MemoryUpdateParams as MemoryUpdateParams
 from .setting_get_response import SettingGetResponse as SettingGetResponse
-from .search_execute_params import SearchExecuteParams as SearchExecuteParams
 from .setting_update_params import SettingUpdateParams as SettingUpdateParams
-from .connection_list_params import ConnectionListParams as ConnectionListParams
-from .memory_delete_response import MemoryDeleteResponse as MemoryDeleteResponse
 from .memory_update_response import MemoryUpdateResponse as MemoryUpdateResponse
 from .connection_get_response import ConnectionGetResponse as ConnectionGetResponse
-from .search_execute_response import SearchExecuteResponse as SearchExecuteResponse
 from .setting_update_response import SettingUpdateResponse as SettingUpdateResponse
 from .connection_create_params import ConnectionCreateParams as ConnectionCreateParams
-from .connection_list_response import ConnectionListResponse as ConnectionListResponse
 from .memory_upload_file_params import MemoryUploadFileParams as MemoryUploadFileParams
 from .connection_create_response import ConnectionCreateResponse as ConnectionCreateResponse
 from .memory_upload_file_response import MemoryUploadFileResponse as MemoryUploadFileResponse

supermemory/types/connection_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Union, Optional
+from typing import Dict, List, Union, Optional
 from typing_extensions import Annotated, TypedDict
 
 from .._utils import PropertyInfo
@@ -11,8 +11,10 @@ __all__ = ["ConnectionCreateParams"]
 
 
 class ConnectionCreateParams(TypedDict, total=False):
-    end_user_id: Annotated[str, PropertyInfo(alias="endUserId")]
+    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
 
-    redirect_url: Annotated[str, PropertyInfo(alias="redirectUrl")]
+    document_limit: Annotated[int, PropertyInfo(alias="documentLimit")]
 
     metadata: Optional[Dict[str, Union[str, float, bool]]]
+
+    redirect_url: Annotated[str, PropertyInfo(alias="redirectUrl")]

supermemory/types/connection_get_response.py

@@ -16,6 +16,10 @@ class ConnectionGetResponse(BaseModel):
 
     provider: str
 
+    document_limit: Optional[float] = FieldInfo(alias="documentLimit", default=None)
+
+    email: Optional[str] = None
+
     expires_at: Optional[float] = FieldInfo(alias="expiresAt", default=None)
 
     metadata: Optional[Dict[str, object]] = None

supermemory/types/memory_add_params.py

@@ -12,7 +12,35 @@ __all__ = ["MemoryAddParams"]
 
 class MemoryAddParams(TypedDict, total=False):
     content: Required[str]
+    """The content to extract and process into a memory.
+
+    This can be a URL to a website, a PDF, an image, or a video.
+
+    Plaintext: Any plaintext format
+
+    URL: A URL to a website, PDF, image, or video
+
+    We automatically detect the content type from the url's response format.
+    """
 
     container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+    """Optional tags this memory should be containerized by.
+
+    This can be an ID for your user, a project ID, or any other identifier you wish
+    to use to group memories.
+    """
+
+    custom_id: Annotated[str, PropertyInfo(alias="customId")]
+    """Optional custom ID of the memory.
+
+    This could be an ID from your database that will uniquely identify this memory.
+    """
 
     metadata: Dict[str, Union[str, float, bool]]
+    """Optional metadata for the memory.
+
+    This is used to store additional information about the memory. You can use this
+    to store any additional information you need about the memory. Metadata can be
+    filtered through. Keys must be strings and are case sensitive. Values can be
+    strings, numbers, or booleans. You cannot nest objects.
+    """