supermemory 3.0.0a29__py3-none-any.whl → 3.1.0__py3-none-any.whl

supermemory/resources/memories.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Union, Mapping, cast
+from typing import Dict, 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, NoneType, NotGiven, FileTypes
+from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, FileTypes, SequenceNotStr, omit, not_given
 from .._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -52,30 +52,33 @@ class MemoriesResource(SyncAPIResource):
         self,
         id: str,
         *,
-        container_tag: str | NotGiven = NOT_GIVEN,
-        container_tags: List[str] | NotGiven = NOT_GIVEN,
-        content: str | NotGiven = NOT_GIVEN,
-        custom_id: str | NotGiven = NOT_GIVEN,
-        metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
+        container_tag: str | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        content: str | Omit = omit,
+        custom_id: str | Omit = omit,
+        file_type: str | Omit = omit,
+        metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
+        mime_type: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryUpdateResponse:
         """
-        Update a memory with any content type (text, url, file, etc.) and metadata
+        Update a document with any content type (text, url, file, etc.) and metadata
 
         Args:
-          container_tag: Optional tag 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.
+          container_tag: Optional tag this document 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
+              documents.
 
-          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this memory should be
+          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this document 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.
+              identifier you wish to use to group documents.
 
-          content: The content to extract and process into a memory. This can be a URL to a
+          content: The content to extract and process into a document. This can be a URL to a
               website, a PDF, an image, or a video.
 
               Plaintext: Any plaintext format
@@ -84,14 +87,22 @@ class MemoriesResource(SyncAPIResource):
 
               We automatically detect the content type from the url's response format.
 
-          custom_id: Optional custom ID of the memory. This could be an ID from your database that
-              will uniquely identify this memory.
+          custom_id: Optional custom ID of the document. This could be an ID from your database that
+              will uniquely identify this document.
 
-          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.
+          file_type:
+              Optional file type override to force specific processing behavior. Valid values:
+              text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
+              notion_doc, webpage, onedrive
+
+          metadata: Optional metadata for the document. This is used to store additional information
+              about the document. You can use this to store any additional information you
+              need about the document. Metadata can be filtered through. Keys must be strings
+              and are case sensitive. Values can be strings, numbers, or booleans. You cannot
+              nest objects.
+
+          mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
+              use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')
 
           extra_headers: Send extra headers
 
@@ -104,14 +115,16 @@ class MemoriesResource(SyncAPIResource):
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return self._patch(
-            f"/v3/memories/{id}",
+            f"/v3/documents/{id}",
             body=maybe_transform(
                 {
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "file_type": file_type,
                     "metadata": metadata,
+                    "mime_type": mime_type,
                 },
                 memory_update_params.MemoryUpdateParams,
             ),
@@ -124,28 +137,29 @@ class MemoriesResource(SyncAPIResource):
     def list(
         self,
         *,
-        container_tags: List[str] | NotGiven = NOT_GIVEN,
-        filters: str | NotGiven = NOT_GIVEN,
-        include_content: bool | NotGiven = NOT_GIVEN,
-        limit: Union[str, float] | NotGiven = NOT_GIVEN,
-        order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
-        page: Union[str, float] | NotGiven = NOT_GIVEN,
-        sort: Literal["createdAt", "updatedAt"] | NotGiven = NOT_GIVEN,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        filters: memory_list_params.Filters | Omit = omit,
+        include_content: bool | Omit = omit,
+        limit: Union[str, float] | Omit = omit,
+        order: Literal["asc", "desc"] | Omit = omit,
+        page: Union[str, float] | Omit = omit,
+        sort: Literal["createdAt", "updatedAt"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryListResponse:
         """
-        Retrieves a paginated list of memories with their metadata and workflow status
+        Retrieves a paginated list of documents with their metadata and workflow status
 
         Args:
-          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.
+          container_tags: Optional tags this document 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
+              documents.
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_content: Whether to include the content field in the response. Warning: This can make
               responses significantly larger.
@@ -167,7 +181,7 @@ class MemoriesResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._post(
-            "/v3/memories/list",
+            "/v3/documents/list",
             body=maybe_transform(
                 {
                     "container_tags": container_tags,
@@ -195,10 +209,10 @@ class MemoriesResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
-        Delete a memory by ID
+        Delete a document by ID or customId
 
         Args:
           extra_headers: Send extra headers
@@ -213,7 +227,7 @@ class MemoriesResource(SyncAPIResource):
             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}",
+            f"/v3/documents/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -223,30 +237,25 @@ class MemoriesResource(SyncAPIResource):
     def add(
         self,
         *,
-        container_tag: str | NotGiven = NOT_GIVEN,
-        container_tags: List[str] | NotGiven = NOT_GIVEN,
-        content: str | NotGiven = NOT_GIVEN,
-        custom_id: str | NotGiven = NOT_GIVEN,
-        metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
+        content: str,
+        container_tag: str | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        custom_id: str | Omit = omit,
+        file_type: str | Omit = omit,
+        metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
+        mime_type: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryAddResponse:
         """
-        Add a memory with any content type (text, url, file, etc.) and metadata
+        Add a document with any content type (text, url, file, etc.) and metadata
 
         Args:
-          container_tag: Optional tag 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.
-
-          container_tags: (DEPRECATED: Use containerTag instead) 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.
-
-          content: The content to extract and process into a memory. This can be a URL to a
+          content: The content to extract and process into a document. This can be a URL to a
               website, a PDF, an image, or a video.
 
               Plaintext: Any plaintext format
@@ -255,14 +264,30 @@ class MemoriesResource(SyncAPIResource):
 
               We automatically detect the content type from the url's response format.
 
-          custom_id: Optional custom ID of the memory. This could be an ID from your database that
-              will uniquely identify this memory.
+          container_tag: Optional tag this document 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
+              documents.
+
+          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this document 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 documents.
+
+          custom_id: Optional custom ID of the document. This could be an ID from your database that
+              will uniquely identify this document.
 
-          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.
+          file_type:
+              Optional file type override to force specific processing behavior. Valid values:
+              text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
+              notion_doc, webpage, onedrive
+
+          metadata: Optional metadata for the document. This is used to store additional information
+              about the document. You can use this to store any additional information you
+              need about the document. Metadata can be filtered through. Keys must be strings
+              and are case sensitive. Values can be strings, numbers, or booleans. You cannot
+              nest objects.
+
+          mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
+              use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')
 
           extra_headers: Send extra headers
 
@@ -273,14 +298,16 @@ class MemoriesResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._post(
-            "/v3/memories",
+            "/v3/documents",
             body=maybe_transform(
                 {
+                    "content": content,
                     "container_tag": container_tag,
                     "container_tags": container_tags,
-                    "content": content,
                     "custom_id": custom_id,
+                    "file_type": file_type,
                     "metadata": metadata,
+                    "mime_type": mime_type,
                 },
                 memory_add_params.MemoryAddParams,
             ),
@@ -299,10 +326,10 @@ class MemoriesResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryGetResponse:
         """
-        Get a memory by ID
+        Get a document by ID
 
         Args:
           extra_headers: Send extra headers
@@ -316,7 +343,7 @@ class MemoriesResource(SyncAPIResource):
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return self._get(
-            f"/v3/memories/{id}",
+            f"/v3/documents/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -327,18 +354,33 @@ class MemoriesResource(SyncAPIResource):
         self,
         *,
         file: FileTypes,
-        container_tags: str | NotGiven = NOT_GIVEN,
+        container_tags: str | Omit = omit,
+        file_type: str | Omit = omit,
+        mime_type: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryUploadFileResponse:
         """
         Upload a file to be processed
 
         Args:
+          file: File to upload and process
+
+          container_tags: Optional JSON string of container tags array. This can be an ID for your user, a
+              project ID, or any other identifier you wish to use to group documents.
+
+          file_type:
+              Optional file type override to force specific processing behavior. Valid values:
+              text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
+              notion_doc, webpage, onedrive
+
+          mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
+              use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -351,6 +393,8 @@ class MemoriesResource(SyncAPIResource):
             {
                 "file": file,
                 "container_tags": container_tags,
+                "file_type": file_type,
+                "mime_type": mime_type,
             }
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
@@ -359,7 +403,7 @@ class MemoriesResource(SyncAPIResource):
         # multipart/form-data; boundary=---abc--
         extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return self._post(
-            "/v3/memories/file",
+            "/v3/documents/file",
             body=maybe_transform(body, memory_upload_file_params.MemoryUploadFileParams),
             files=files,
             options=make_request_options(
@@ -393,30 +437,33 @@ class AsyncMemoriesResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        container_tag: str | NotGiven = NOT_GIVEN,
-        container_tags: List[str] | NotGiven = NOT_GIVEN,
-        content: str | NotGiven = NOT_GIVEN,
-        custom_id: str | NotGiven = NOT_GIVEN,
-        metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
+        container_tag: str | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        content: str | Omit = omit,
+        custom_id: str | Omit = omit,
+        file_type: str | Omit = omit,
+        metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
+        mime_type: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryUpdateResponse:
         """
-        Update a memory with any content type (text, url, file, etc.) and metadata
+        Update a document with any content type (text, url, file, etc.) and metadata
 
         Args:
-          container_tag: Optional tag 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.
+          container_tag: Optional tag this document 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
+              documents.
 
-          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this memory should be
+          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this document 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.
+              identifier you wish to use to group documents.
 
-          content: The content to extract and process into a memory. This can be a URL to a
+          content: The content to extract and process into a document. This can be a URL to a
               website, a PDF, an image, or a video.
 
               Plaintext: Any plaintext format
@@ -425,14 +472,22 @@ class AsyncMemoriesResource(AsyncAPIResource):
 
               We automatically detect the content type from the url's response format.
 
-          custom_id: Optional custom ID of the memory. This could be an ID from your database that
-              will uniquely identify this memory.
+          custom_id: Optional custom ID of the document. This could be an ID from your database that
+              will uniquely identify this document.
 
-          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.
+          file_type:
+              Optional file type override to force specific processing behavior. Valid values:
+              text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
+              notion_doc, webpage, onedrive
+
+          metadata: Optional metadata for the document. This is used to store additional information
+              about the document. You can use this to store any additional information you
+              need about the document. Metadata can be filtered through. Keys must be strings
+              and are case sensitive. Values can be strings, numbers, or booleans. You cannot
+              nest objects.
+
+          mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
+              use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')
 
           extra_headers: Send extra headers
 
@@ -445,14 +500,16 @@ class AsyncMemoriesResource(AsyncAPIResource):
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return await self._patch(
-            f"/v3/memories/{id}",
+            f"/v3/documents/{id}",
             body=await async_maybe_transform(
                 {
                     "container_tag": container_tag,
                     "container_tags": container_tags,
                     "content": content,
                     "custom_id": custom_id,
+                    "file_type": file_type,
                     "metadata": metadata,
+                    "mime_type": mime_type,
                 },
                 memory_update_params.MemoryUpdateParams,
             ),
@@ -465,28 +522,29 @@ class AsyncMemoriesResource(AsyncAPIResource):
     async def list(
         self,
         *,
-        container_tags: List[str] | NotGiven = NOT_GIVEN,
-        filters: str | NotGiven = NOT_GIVEN,
-        include_content: bool | NotGiven = NOT_GIVEN,
-        limit: Union[str, float] | NotGiven = NOT_GIVEN,
-        order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
-        page: Union[str, float] | NotGiven = NOT_GIVEN,
-        sort: Literal["createdAt", "updatedAt"] | NotGiven = NOT_GIVEN,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        filters: memory_list_params.Filters | Omit = omit,
+        include_content: bool | Omit = omit,
+        limit: Union[str, float] | Omit = omit,
+        order: Literal["asc", "desc"] | Omit = omit,
+        page: Union[str, float] | Omit = omit,
+        sort: Literal["createdAt", "updatedAt"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryListResponse:
         """
-        Retrieves a paginated list of memories with their metadata and workflow status
+        Retrieves a paginated list of documents with their metadata and workflow status
 
         Args:
-          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.
+          container_tags: Optional tags this document 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
+              documents.
 
-          filters: Optional filters to apply to the search
+          filters: Optional filters to apply to the search. Can be a JSON string or Query object.
 
           include_content: Whether to include the content field in the response. Warning: This can make
               responses significantly larger.
@@ -508,7 +566,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return await self._post(
-            "/v3/memories/list",
+            "/v3/documents/list",
             body=await async_maybe_transform(
                 {
                     "container_tags": container_tags,
@@ -536,10 +594,10 @@ class AsyncMemoriesResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
-        Delete a memory by ID
+        Delete a document by ID or customId
 
         Args:
           extra_headers: Send extra headers
@@ -554,7 +612,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
             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}",
+            f"/v3/documents/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -564,30 +622,25 @@ class AsyncMemoriesResource(AsyncAPIResource):
     async def add(
         self,
         *,
-        container_tag: str | NotGiven = NOT_GIVEN,
-        container_tags: List[str] | NotGiven = NOT_GIVEN,
-        content: str | NotGiven = NOT_GIVEN,
-        custom_id: str | NotGiven = NOT_GIVEN,
-        metadata: Dict[str, Union[str, float, bool]] | NotGiven = NOT_GIVEN,
+        content: str,
+        container_tag: str | Omit = omit,
+        container_tags: SequenceNotStr[str] | Omit = omit,
+        custom_id: str | Omit = omit,
+        file_type: str | Omit = omit,
+        metadata: Dict[str, Union[str, float, bool, SequenceNotStr[str]]] | Omit = omit,
+        mime_type: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryAddResponse:
         """
-        Add a memory with any content type (text, url, file, etc.) and metadata
+        Add a document with any content type (text, url, file, etc.) and metadata
 
         Args:
-          container_tag: Optional tag 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.
-
-          container_tags: (DEPRECATED: Use containerTag instead) 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.
-
-          content: The content to extract and process into a memory. This can be a URL to a
+          content: The content to extract and process into a document. This can be a URL to a
               website, a PDF, an image, or a video.
 
               Plaintext: Any plaintext format
@@ -596,14 +649,30 @@ class AsyncMemoriesResource(AsyncAPIResource):
 
               We automatically detect the content type from the url's response format.
 
-          custom_id: Optional custom ID of the memory. This could be an ID from your database that
-              will uniquely identify this memory.
+          container_tag: Optional tag this document 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
+              documents.
+
+          container_tags: (DEPRECATED: Use containerTag instead) Optional tags this document 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 documents.
+
+          custom_id: Optional custom ID of the document. This could be an ID from your database that
+              will uniquely identify this document.
 
-          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.
+          file_type:
+              Optional file type override to force specific processing behavior. Valid values:
+              text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
+              notion_doc, webpage, onedrive
+
+          metadata: Optional metadata for the document. This is used to store additional information
+              about the document. You can use this to store any additional information you
+              need about the document. Metadata can be filtered through. Keys must be strings
+              and are case sensitive. Values can be strings, numbers, or booleans. You cannot
+              nest objects.
+
+          mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
+              use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')
 
           extra_headers: Send extra headers
 
@@ -614,14 +683,16 @@ class AsyncMemoriesResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return await self._post(
-            "/v3/memories",
+            "/v3/documents",
             body=await async_maybe_transform(
                 {
+                    "content": content,
                     "container_tag": container_tag,
                     "container_tags": container_tags,
-                    "content": content,
                     "custom_id": custom_id,
+                    "file_type": file_type,
                     "metadata": metadata,
+                    "mime_type": mime_type,
                 },
                 memory_add_params.MemoryAddParams,
             ),
@@ -640,10 +711,10 @@ class AsyncMemoriesResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryGetResponse:
         """
-        Get a memory by ID
+        Get a document by ID
 
         Args:
           extra_headers: Send extra headers
@@ -657,7 +728,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return await self._get(
-            f"/v3/memories/{id}",
+            f"/v3/documents/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -668,18 +739,33 @@ class AsyncMemoriesResource(AsyncAPIResource):
         self,
         *,
         file: FileTypes,
-        container_tags: str | NotGiven = NOT_GIVEN,
+        container_tags: str | Omit = omit,
+        file_type: str | Omit = omit,
+        mime_type: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> MemoryUploadFileResponse:
         """
         Upload a file to be processed
 
         Args:
+          file: File to upload and process
+
+          container_tags: Optional JSON string of container tags array. This can be an ID for your user, a
+              project ID, or any other identifier you wish to use to group documents.
+
+          file_type:
+              Optional file type override to force specific processing behavior. Valid values:
+              text, pdf, tweet, google_doc, google_slide, google_sheet, image, video,
+              notion_doc, webpage, onedrive
+
+          mime_type: Required when fileType is 'image' or 'video'. Specifies the exact MIME type to
+              use (e.g., 'image/png', 'image/jpeg', 'video/mp4', 'video/webm')
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -692,6 +778,8 @@ class AsyncMemoriesResource(AsyncAPIResource):
             {
                 "file": file,
                 "container_tags": container_tags,
+                "file_type": file_type,
+                "mime_type": mime_type,
             }
         )
         files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
@@ -700,7 +788,7 @@ class AsyncMemoriesResource(AsyncAPIResource):
         # multipart/form-data; boundary=---abc--
         extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return await self._post(
-            "/v3/memories/file",
+            "/v3/documents/file",
             body=await async_maybe_transform(body, memory_upload_file_params.MemoryUploadFileParams),
             files=files,
             options=make_request_options(